@effect-gql/persisted-queries 0.1.0 → 1.0.0

package/dist/persisted-queries-router.js

@@ -1,277 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.makePersistedQueriesRouter = void 0;
-const platform_1 = require("@effect/platform");
-const effect_1 = require("effect");
-const graphql_1 = require("graphql");
-const server_1 = require("@effect-gql/core/server");
-const core_1 = require("@effect-gql/core");
-const store_1 = require("./store");
-const memory_store_1 = require("./memory-store");
-const errors_1 = require("./errors");
-const utils_1 = require("./utils");
-/**
- * Create a GraphQL router with Apollo Persisted Queries support.
- *
- * This creates a complete GraphQL router that includes:
- * - Apollo Persisted Queries (APQ) support
- * - GET request support for CDN caching
- * - All standard GraphQL router features (validation, execution, extensions)
- *
- * ## Apollo APQ Protocol
- *
- * 1. Client sends request with `extensions.persistedQuery.sha256Hash`
- * 2. If hash found in store, execute the stored query
- * 3. If hash NOT found and query provided (APQ mode), store it and execute
- * 4. If hash NOT found and NO query, return `PERSISTED_QUERY_NOT_FOUND`
- * 5. Client retries with both hash and query
- *
- * ## Modes
- *
- * - **APQ mode** (`mode: "apq"`): Automatic runtime registration.
- *   Unknown queries trigger NOT_FOUND, prompting client retry with full query.
- *
- * - **Safelist mode** (`mode: "safelist"`): Pre-registered queries only.
- *   Unknown queries return NOT_ALLOWED error. Use with `makeSafelistStore()`.
- *
- * @example APQ Mode (default)
- * ```typescript
- * import { makePersistedQueriesRouter } from "@effect-gql/persisted-queries"
- *
- * const router = makePersistedQueriesRouter(schema, serviceLayer, {
- *   mode: "apq",
- *   enableGet: true,
- *   graphiql: { path: "/graphiql" },
- * })
- * ```
- *
- * @example Safelist Mode
- * ```typescript
- * import { makePersistedQueriesRouter, makeSafelistStore } from "@effect-gql/persisted-queries"
- *
- * const router = makePersistedQueriesRouter(schema, serviceLayer, {
- *   mode: "safelist",
- *   store: makeSafelistStore({
- *     "abc123...": "query GetUser($id: ID!) { user(id: $id) { name } }",
- *   }),
- * })
- * ```
- *
- * @param schema - The GraphQL schema
- * @param layer - Effect layer providing services required by resolvers
- * @param options - Router and persisted query configuration
- * @returns An HttpRouter with persisted query support
- */
-const makePersistedQueriesRouter = (schema, layer, options = {}) => {
-    const mode = options.mode ?? "apq";
-    const enableGet = options.enableGet ?? true;
-    const validateHashOption = options.validateHash ?? true;
-    const hashAlgorithm = options.hashAlgorithm ?? "sha256";
-    // Core router config
-    const resolvedConfig = (0, server_1.normalizeConfig)(options);
-    const fieldComplexities = options.fieldComplexities ?? new Map();
-    const extensions = options.extensions ?? [];
-    const errorHandler = options.errorHandler ?? server_1.defaultErrorHandler;
-    // Create the store layer (default to in-memory)
-    const baseStoreLayer = options.store ?? (0, memory_store_1.makeMemoryStore)();
-    /**
-     * Resolve a persisted query from the store or register it.
-     * Returns the resolved request body with the query filled in.
-     */
-    const resolvePersistedQuery = (body) => effect_1.Effect.gen(function* () {
-        const persistedQuery = (0, utils_1.parsePersistedQueryExtension)(body.extensions);
-        if (!persistedQuery) {
-            // No persisted query extension - pass through unchanged
-            return body;
-        }
-        // Validate version
-        if (persistedQuery.version !== 1) {
-            return yield* effect_1.Effect.fail(new errors_1.PersistedQueryVersionError({ version: persistedQuery.version }));
-        }
-        const hash = persistedQuery.sha256Hash;
-        const store = yield* store_1.PersistedQueryStore;
-        // Check if we have the query stored
-        const storedQuery = yield* store.get(hash);
-        if (effect_1.Option.isSome(storedQuery)) {
-            // Query found - use it
-            return {
-                ...body,
-                query: storedQuery.value,
-            };
-        }
-        // Query not found in store
-        if (!body.query) {
-            // No query provided - client needs to send it
-            return yield* effect_1.Effect.fail(new errors_1.PersistedQueryNotFoundError({ hash }));
-        }
-        // Query provided - check mode
-        if (mode === "safelist") {
-            // Safelist mode: reject unknown queries
-            return yield* effect_1.Effect.fail(new errors_1.PersistedQueryNotAllowedError({ hash }));
-        }
-        // APQ mode: validate hash and store
-        if (validateHashOption) {
-            const computed = yield* (0, utils_1.computeHash)(body.query, hashAlgorithm);
-            if (computed !== hash) {
-                return yield* effect_1.Effect.fail(new errors_1.PersistedQueryHashMismatchError({
-                    providedHash: hash,
-                    computedHash: computed,
-                }));
-            }
-        }
-        // Store the query for future requests
-        yield* store.set(hash, body.query);
-        return body;
-    });
-    /**
-     * Main GraphQL handler with APQ support
-     */
-    const createHandler = (parseBody) => effect_1.Effect.gen(function* () {
-        // Parse request body
-        const rawBody = yield* parseBody.pipe(effect_1.Effect.catchAll((error) => effect_1.Effect.succeed({
-            _parseError: true,
-            message: error.message,
-        })));
-        if ("_parseError" in rawBody) {
-            return yield* platform_1.HttpServerResponse.json({ errors: [{ message: rawBody.message }] }, { status: 400 });
-        }
-        // Resolve persisted query
-        const bodyResult = yield* resolvePersistedQuery(rawBody).pipe(effect_1.Effect.provide(baseStoreLayer), effect_1.Effect.either);
-        if (bodyResult._tag === "Left") {
-            // APQ error - return appropriate GraphQL error response
-            const error = bodyResult.left;
-            return yield* platform_1.HttpServerResponse.json({
-                errors: [error.toGraphQLError()],
-            });
-        }
-        const body = bodyResult.right;
-        // Check if we have a query to execute
-        if (!body.query) {
-            return yield* platform_1.HttpServerResponse.json({ errors: [{ message: "No query provided" }] }, { status: 400 });
-        }
-        // Create the ExtensionsService for this request
-        const extensionsService = yield* (0, core_1.makeExtensionsService)();
-        // Get the runtime from the layer
-        const runtime = yield* effect_1.Effect.runtime();
-        // Phase 1: Parse
-        let document;
-        try {
-            document = (0, graphql_1.parse)(body.query);
-        }
-        catch (parseError) {
-            const extensionData = yield* extensionsService.get();
-            return yield* platform_1.HttpServerResponse.json({
-                errors: [{ message: String(parseError) }],
-                extensions: Object.keys(extensionData).length > 0 ? extensionData : undefined,
-            });
-        }
-        // Run onParse hooks
-        yield* (0, core_1.runParseHooks)(extensions, body.query, document).pipe(effect_1.Effect.provideService(core_1.ExtensionsService, extensionsService));
-        // Phase 2: Validate
-        // Add NoSchemaIntrospectionCustomRule if introspection is disabled
-        const validationRules = resolvedConfig.introspection
-            ? undefined
-            : [...graphql_1.specifiedRules, graphql_1.NoSchemaIntrospectionCustomRule];
-        const validationErrors = (0, graphql_1.validate)(schema, document, validationRules);
-        // Run onValidate hooks
-        yield* (0, core_1.runValidateHooks)(extensions, document, validationErrors).pipe(effect_1.Effect.provideService(core_1.ExtensionsService, extensionsService));
-        // If validation failed, return errors without executing
-        if (validationErrors.length > 0) {
-            const extensionData = yield* extensionsService.get();
-            return yield* platform_1.HttpServerResponse.json({
-                errors: validationErrors.map((e) => ({
-                    message: e.message,
-                    locations: e.locations,
-                    path: e.path,
-                })),
-                extensions: Object.keys(extensionData).length > 0 ? extensionData : undefined,
-            }, { status: 400 });
-        }
-        // Validate query complexity if configured
-        if (resolvedConfig.complexity) {
-            yield* (0, server_1.validateComplexity)(body.query, body.operationName, body.variables, schema, fieldComplexities, resolvedConfig.complexity).pipe(effect_1.Effect.catchTag("ComplexityLimitExceededError", (error) => effect_1.Effect.fail(error)), effect_1.Effect.catchTag("ComplexityAnalysisError", (error) => effect_1.Effect.logWarning("Complexity analysis failed", error)));
-        }
-        // Phase 3: Execute
-        const executionArgs = {
-            source: body.query,
-            document,
-            variableValues: body.variables,
-            operationName: body.operationName,
-            schema,
-            fieldComplexities,
-        };
-        // Run onExecuteStart hooks
-        yield* (0, core_1.runExecuteStartHooks)(extensions, executionArgs).pipe(effect_1.Effect.provideService(core_1.ExtensionsService, extensionsService));
-        // Execute GraphQL query
-        const executeResult = yield* effect_1.Effect.try({
-            try: () => (0, graphql_1.execute)({
-                schema,
-                document,
-                variableValues: body.variables,
-                operationName: body.operationName,
-                contextValue: { runtime },
-            }),
-            catch: (error) => new Error(String(error)),
-        });
-        // Await result if it's a promise
-        const resolvedResult = executeResult && typeof executeResult === "object" && "then" in executeResult
-            ? yield* effect_1.Effect.promise(() => executeResult)
-            : executeResult;
-        // Run onExecuteEnd hooks
-        yield* (0, core_1.runExecuteEndHooks)(extensions, resolvedResult).pipe(effect_1.Effect.provideService(core_1.ExtensionsService, extensionsService));
-        // Merge extension data into result
-        const extensionData = yield* extensionsService.get();
-        const finalResult = Object.keys(extensionData).length > 0
-            ? {
-                ...resolvedResult,
-                extensions: {
-                    ...resolvedResult.extensions,
-                    ...extensionData,
-                },
-            }
-            : resolvedResult;
-        return yield* platform_1.HttpServerResponse.json(finalResult);
-    }).pipe(effect_1.Effect.provide(layer), effect_1.Effect.catchAll((error) => {
-        if (error instanceof server_1.ComplexityLimitExceededError) {
-            return platform_1.HttpServerResponse.json({
-                errors: [
-                    {
-                        message: error.message,
-                        extensions: {
-                            code: "COMPLEXITY_LIMIT_EXCEEDED",
-                            limitType: error.limitType,
-                            limit: error.limit,
-                            actual: error.actual,
-                        },
-                    },
-                ],
-            }, { status: 400 }).pipe(effect_1.Effect.orDie);
-        }
-        return effect_1.Effect.fail(error);
-    }), effect_1.Effect.catchAllCause(errorHandler));
-    // POST handler
-    const postHandler = createHandler(effect_1.Effect.gen(function* () {
-        const request = yield* platform_1.HttpServerRequest.HttpServerRequest;
-        return yield* request.json;
-    }));
-    // GET handler for CDN-cacheable persisted queries
-    const getHandler = createHandler(effect_1.Effect.gen(function* () {
-        const request = yield* platform_1.HttpServerRequest.HttpServerRequest;
-        const url = new URL(request.url, "http://localhost");
-        return yield* (0, utils_1.parseGetRequestBody)(url.searchParams);
-    }));
-    // Build router
-    let router = platform_1.HttpRouter.empty.pipe(platform_1.HttpRouter.post(resolvedConfig.path, postHandler));
-    // Add GET handler if enabled
-    if (enableGet) {
-        router = router.pipe(platform_1.HttpRouter.get(resolvedConfig.path, getHandler));
-    }
-    // Add GraphiQL route if enabled
-    if (resolvedConfig.graphiql) {
-        const { path, endpoint } = resolvedConfig.graphiql;
-        router = router.pipe(platform_1.HttpRouter.get(path, platform_1.HttpServerResponse.html((0, server_1.graphiqlHtml)(endpoint))));
-    }
-    return router;
-};
-exports.makePersistedQueriesRouter = makePersistedQueriesRouter;
-//# sourceMappingURL=persisted-queries-router.js.map

package/dist/persisted-queries-router.js.map

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

package/dist/store.d.ts

@@ -1,49 +0,0 @@
-import { Context, Effect, Option } from "effect";
-/**
- * Interface for persisted query storage.
- *
- * Implementations can be in-memory LRU cache, Redis, database, etc.
- * The interface uses Effect for consistency with the rest of the framework.
- */
-export interface PersistedQueryStore {
-    /**
-     * Get a query by its hash.
-     * Returns Option.none() if not found.
-     */
-    readonly get: (hash: string) => Effect.Effect<Option.Option<string>>;
-    /**
-     * Store a query with its hash.
-     * In safelist mode, this may be a no-op.
-     */
-    readonly set: (hash: string, query: string) => Effect.Effect<void>;
-    /**
-     * Check if a hash exists in the store without retrieving the query.
-     * More efficient for large queries when you only need existence check.
-     */
-    readonly has: (hash: string) => Effect.Effect<boolean>;
-}
-/**
- * Service tag for the PersistedQueryStore.
- *
- * Use this tag to provide a store implementation via Effect's dependency injection.
- *
- * @example
- * ```typescript
- * import { PersistedQueryStore, makeMemoryStore } from "@effect-gql/persisted-queries"
- *
- * // Create a layer with the memory store
- * const storeLayer = makeMemoryStore({ maxSize: 1000 })
- *
- * // Use in an Effect
- * const program = Effect.gen(function* () {
- *   const store = yield* PersistedQueryStore
- *   yield* store.set("abc123", "query { hello }")
- *   const query = yield* store.get("abc123")
- *   // query: Option.some("query { hello }")
- * })
- *
- * Effect.runPromise(Effect.provide(program, storeLayer))
- * ```
- */
-export declare const PersistedQueryStore: Context.Tag<PersistedQueryStore, PersistedQueryStore>;
-//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;IAEpE;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAElE;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;CACvD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,mBAAmB,uDAE/B,CAAA"}

package/dist/store.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PersistedQueryStore = void 0;
-const effect_1 = require("effect");
-/**
- * Service tag for the PersistedQueryStore.
- *
- * Use this tag to provide a store implementation via Effect's dependency injection.
- *
- * @example
- * ```typescript
- * import { PersistedQueryStore, makeMemoryStore } from "@effect-gql/persisted-queries"
- *
- * // Create a layer with the memory store
- * const storeLayer = makeMemoryStore({ maxSize: 1000 })
- *
- * // Use in an Effect
- * const program = Effect.gen(function* () {
- *   const store = yield* PersistedQueryStore
- *   yield* store.set("abc123", "query { hello }")
- *   const query = yield* store.get("abc123")
- *   // query: Option.some("query { hello }")
- * })
- *
- * Effect.runPromise(Effect.provide(program, storeLayer))
- * ```
- */
-exports.PersistedQueryStore = effect_1.Context.GenericTag("@effect-gql/persisted-queries/PersistedQueryStore");
-//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":";;;AAAA,mCAAgD;AA4BhD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACU,QAAA,mBAAmB,GAAG,gBAAO,CAAC,UAAU,CACnD,mDAAmD,CACpD,CAAA"}

package/dist/utils.d.ts

@@ -1,51 +0,0 @@
-import { Effect } from "effect";
-import type { HashAlgorithm } from "./config";
-/**
- * Compute the hash of a query string.
- *
- * @param query - The GraphQL query string to hash
- * @param algorithm - Hash algorithm to use (default: sha256)
- * @returns Effect that resolves to the hex-encoded hash
- */
-export declare const computeHash: (query: string, algorithm?: HashAlgorithm) => Effect.Effect<string>;
-/**
- * Structure of the persisted query extension in GraphQL requests.
- * This follows the Apollo APQ protocol.
- */
-export interface PersistedQueryExtension {
-    readonly version: number;
-    readonly sha256Hash: string;
-}
-/**
- * Parse and validate the persisted query extension from request extensions.
- *
- * @param extensions - The extensions object from the GraphQL request
- * @returns The parsed persisted query extension, or null if not present/invalid
- */
-export declare const parsePersistedQueryExtension: (extensions: unknown) => PersistedQueryExtension | null;
-/**
- * GraphQL request body structure with optional persisted query extension.
- */
-export interface GraphQLRequestBody {
-    query?: string;
-    variables?: Record<string, unknown>;
-    operationName?: string;
-    extensions?: {
-        persistedQuery?: PersistedQueryExtension;
-        [key: string]: unknown;
-    };
-}
-/**
- * Parse a GET request's query parameters into a GraphQL request body.
- *
- * Supports the following query parameters:
- * - `query`: The GraphQL query string (optional with persisted queries)
- * - `variables`: JSON-encoded variables object
- * - `operationName`: Name of the operation to execute
- * - `extensions`: JSON-encoded extensions object containing persistedQuery
- *
- * @param searchParams - URLSearchParams from the request URL
- * @returns Effect that resolves to the parsed request body or fails with parse error
- */
-export declare const parseGetRequestBody: (searchParams: URLSearchParams) => Effect.Effect<GraphQLRequestBody, Error>;
-//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,MAAM,EACb,YAAW,aAAwB,KAClC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAyE,CAAA;AAEhG;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,YAAY,OAAO,KAClB,uBAAuB,GAAG,IAmB5B,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE;QACX,cAAc,CAAC,EAAE,uBAAuB,CAAA;QACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;CACF;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAC9B,cAAc,eAAe,KAC5B,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,CA6BtC,CAAA"}

package/dist/utils.js

@@ -1,73 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseGetRequestBody = exports.parsePersistedQueryExtension = exports.computeHash = void 0;
-const effect_1 = require("effect");
-const crypto_1 = require("crypto");
-/**
- * Compute the hash of a query string.
- *
- * @param query - The GraphQL query string to hash
- * @param algorithm - Hash algorithm to use (default: sha256)
- * @returns Effect that resolves to the hex-encoded hash
- */
-const computeHash = (query, algorithm = "sha256") => effect_1.Effect.sync(() => (0, crypto_1.createHash)(algorithm).update(query).digest("hex"));
-exports.computeHash = computeHash;
-/**
- * Parse and validate the persisted query extension from request extensions.
- *
- * @param extensions - The extensions object from the GraphQL request
- * @returns The parsed persisted query extension, or null if not present/invalid
- */
-const parsePersistedQueryExtension = (extensions) => {
-    if (typeof extensions !== "object" || extensions === null || !("persistedQuery" in extensions)) {
-        return null;
-    }
-    const pq = extensions.persistedQuery;
-    if (typeof pq !== "object" || pq === null || !("version" in pq) || !("sha256Hash" in pq)) {
-        return null;
-    }
-    const version = pq.version;
-    const sha256Hash = pq.sha256Hash;
-    if (typeof version !== "number" || typeof sha256Hash !== "string") {
-        return null;
-    }
-    return { version, sha256Hash };
-};
-exports.parsePersistedQueryExtension = parsePersistedQueryExtension;
-/**
- * Parse a GET request's query parameters into a GraphQL request body.
- *
- * Supports the following query parameters:
- * - `query`: The GraphQL query string (optional with persisted queries)
- * - `variables`: JSON-encoded variables object
- * - `operationName`: Name of the operation to execute
- * - `extensions`: JSON-encoded extensions object containing persistedQuery
- *
- * @param searchParams - URLSearchParams from the request URL
- * @returns Effect that resolves to the parsed request body or fails with parse error
- */
-const parseGetRequestBody = (searchParams) => effect_1.Effect.try({
-    try: () => {
-        const extensionsRaw = searchParams.get("extensions");
-        const variablesRaw = searchParams.get("variables");
-        const result = {};
-        const query = searchParams.get("query");
-        if (query) {
-            result.query = query;
-        }
-        const operationName = searchParams.get("operationName");
-        if (operationName) {
-            result.operationName = operationName;
-        }
-        if (variablesRaw) {
-            result.variables = JSON.parse(variablesRaw);
-        }
-        if (extensionsRaw) {
-            result.extensions = JSON.parse(extensionsRaw);
-        }
-        return result;
-    },
-    catch: (e) => new Error(`Failed to parse query parameters: ${e}`),
-});
-exports.parseGetRequestBody = parseGetRequestBody;
-//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AAAA,mCAA+B;AAC/B,mCAAmC;AAGnC;;;;;;GAMG;AACI,MAAM,WAAW,GAAG,CACzB,KAAa,EACb,YAA2B,QAAQ,EACZ,EAAE,CAAC,eAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAA,mBAAU,EAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AAHnF,QAAA,WAAW,eAGwE;AAWhG;;;;;GAKG;AACI,MAAM,4BAA4B,GAAG,CAC1C,UAAmB,EACa,EAAE;IAClC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,CAAC,gBAAgB,IAAI,UAAU,CAAC,EAAE,CAAC;QAC/F,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,EAAE,GAAI,UAAsC,CAAC,cAAc,CAAA;IAEjE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;QACzF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,OAAO,GAAI,EAA8B,CAAC,OAAO,CAAA;IACvD,MAAM,UAAU,GAAI,EAA8B,CAAC,UAAU,CAAA;IAE7D,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAClE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;AAChC,CAAC,CAAA;AArBY,QAAA,4BAA4B,gCAqBxC;AAeD;;;;;;;;;;;GAWG;AACI,MAAM,mBAAmB,GAAG,CACjC,YAA6B,EACa,EAAE,CAC5C,eAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE;QACR,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QACpD,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QAElD,MAAM,MAAM,GAAuB,EAAE,CAAA;QAErC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACvC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;QACtB,CAAC;QAED,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;QACvD,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,CAAC,aAAa,GAAG,aAAa,CAAA;QACtC,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;QAC7C,CAAC;QAED,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;QAC/C,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IACD,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,EAAE,CAAC;CAClE,CAAC,CAAA;AA/BS,QAAA,mBAAmB,uBA+B5B"}

package/src/config.ts

@@ -1,122 +0,0 @@
-import { Config, Layer } from "effect"
-import type { PersistedQueryStore } from "./store"
-import type { MakeGraphQLRouterOptions } from "@effect-gql/core/server"
-
-/**
- * Operating mode for persisted queries.
- *
- * - `"apq"`: Automatic Persisted Queries - clients can register queries at runtime
- * - `"safelist"`: Only pre-registered queries are allowed (security mode)
- */
-export type PersistedQueryMode = "apq" | "safelist"
-
-/**
- * Hash algorithm used for query hashing.
- * Must match what clients use - Apollo clients use SHA-256.
- */
-export type HashAlgorithm = "sha256" | "sha512"
-
-/**
- * Configuration for the persisted queries feature.
- */
-export interface PersistedQueriesConfig {
-  /**
-   * Operating mode.
-   *
-   * - `"apq"`: Automatic Persisted Queries - clients can register queries at runtime.
-   *   Unknown hashes trigger PERSISTED_QUERY_NOT_FOUND, prompting clients to retry with query.
-   *
-   * - `"safelist"`: Only pre-registered queries are allowed.
-   *   Unknown hashes return PERSISTED_QUERY_NOT_ALLOWED error.
-   *   Use with `makeSafelistStore()` for production security.
-   *
-   * Default: `"apq"`
-   */
-  readonly mode?: PersistedQueryMode
-
-  /**
-   * Layer providing the PersistedQueryStore service.
-   *
-   * Defaults to in-memory LRU store with 1000 entries.
-   * Use `makeMemoryStore()` for custom size or `makeSafelistStore()` for safelist mode.
-   *
-   * @example
-   * ```typescript
-   * // Custom memory store
-   * store: makeMemoryStore({ maxSize: 5000 })
-   *
-   * // Safelist store
-   * store: makeSafelistStore({ "hash1": "query {...}", "hash2": "query {...}" })
-   * ```
-   */
-  readonly store?: Layer.Layer<PersistedQueryStore>
-
-  /**
-   * Whether to support GET requests with query parameters.
-   *
-   * When enabled, the router accepts:
-   * ```
-   * GET /graphql?extensions={"persistedQuery":{"version":1,"sha256Hash":"..."}}&variables={...}&operationName=...
-   * ```
-   *
-   * This enables CDN caching since the same hash always maps to the same URL.
-   *
-   * Default: `true`
-   */
-  readonly enableGet?: boolean
-
-  /**
-   * Validate that the provided query matches its hash when storing.
-   *
-   * This prevents hash collision attacks where a malicious client could
-   * register a different query under someone else's hash.
-   *
-   * Has a slight performance overhead for computing the hash.
-   *
-   * Default: `true`
-   */
-  readonly validateHash?: boolean
-
-  /**
-   * Hash algorithm to use for validation.
-   * Must match what clients use - Apollo clients use SHA-256.
-   *
-   * Default: `"sha256"`
-   */
-  readonly hashAlgorithm?: HashAlgorithm
-}
-
-/**
- * Options for the persisted queries router.
- *
- * Extends the standard GraphQL router options with persisted query configuration.
- */
-export interface PersistedQueriesRouterOptions
-  extends MakeGraphQLRouterOptions, PersistedQueriesConfig {}
-
-/**
- * Effect Config for loading persisted queries settings from environment variables.
- *
- * Environment variables:
- * - `PERSISTED_QUERIES_MODE`: `"apq"` | `"safelist"` (default: `"apq"`)
- * - `PERSISTED_QUERIES_ENABLE_GET`: boolean (default: `true`)
- * - `PERSISTED_QUERIES_VALIDATE_HASH`: boolean (default: `true`)
- *
- * Note: The store must still be provided programmatically.
- *
- * @example
- * ```typescript
- * import { PersistedQueriesConfigFromEnv } from "@effect-gql/persisted-queries"
- *
- * const config = yield* Config.unwrap(PersistedQueriesConfigFromEnv)
- * ```
- */
-export const PersistedQueriesConfigFromEnv: Config.Config<Omit<PersistedQueriesConfig, "store">> =
-  Config.all({
-    mode: Config.literal(
-      "apq",
-      "safelist"
-    )("PERSISTED_QUERIES_MODE").pipe(Config.withDefault("apq" as const)),
-    enableGet: Config.boolean("PERSISTED_QUERIES_ENABLE_GET").pipe(Config.withDefault(true)),
-    validateHash: Config.boolean("PERSISTED_QUERIES_VALIDATE_HASH").pipe(Config.withDefault(true)),
-  })