@ankhorage/data-sources 1.0.1 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/data-sources
 
+## 2.0.0
+
+### Major Changes
+
+- 5be6ff8: Consume canonical Contracts v8 API definitions directly, execute external REST and GraphQL APIs without database projection, and remove the generated-API data-source surface.
+
 ## 1.0.1
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/data-sources
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v0.6.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v1.0.1](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Provider-neutral data source and endpoint system for APIs, databases, and runtime bindings.
 
@@ -15,46 +15,11 @@ Provider-neutral data source and endpoint system for APIs, databases, and runtim
 - [Architecture overview](././paradox/diagrams/architecture-overview.mmd)
 - [Module relationships](././paradox/diagrams/module-relationships.mmd)
 - [Export graph](././paradox/diagrams/export-graph.mmd)
-- [createGeneratedApiResourceSchema sequence](././paradox/diagrams/sequences/create-generated-api-resource-schema.mmd)
-- [createManualRestDataSource sequence](././paradox/diagrams/sequences/create-manual-rest-data-source.mmd)
+- [createGraphQlApi sequence](././paradox/diagrams/sequences/create-graph-ql-api.mmd)
+- [createManualRestApi sequence](././paradox/diagrams/sequences/create-manual-rest-api.mmd)
 - [createOpenApiDiscoveryCandidates sequence](././paradox/diagrams/sequences/create-open-api-discovery-candidates.mmd)
+- [importOpenApiDocument sequence](././paradox/diagrams/sequences/import-open-api-document.mmd)
+- [normalizeGraphQlApi sequence](././paradox/diagrams/sequences/normalize-graph-ql-api.mmd)
 - [normalizeGraphQlIntrospectionOperations sequence](././paradox/diagrams/sequences/normalize-graph-ql-introspection-operations.mmd)
-- [normalizeGraphQlIntrospectionSchemas sequence](././paradox/diagrams/sequences/normalize-graph-ql-introspection-schemas.mmd)
-- [normalizeManualRestDataSource sequence](././paradox/diagrams/sequences/normalize-manual-rest-data-source.mmd)
 - [normalizeOpenApiSchema sequence](././paradox/diagrams/sequences/normalize-open-api-schema.mmd)
-- [validateGeneratedApiDefinition sequence](././paradox/diagrams/sequences/validate-generated-api-definition.mmd)
-- [validateManualRestDataSource sequence](././paradox/diagrams/sequences/validate-manual-rest-data-source.mmd)
-
-## Architecture preview
-
-<details>
-<summary>Architecture overview</summary>
-
-```mermaid
-graph TD
-  package__ankhorage_data_sources["@ankhorage/data-sources"]
-  entrypoint_src_index_ts["src/index.ts"]
-  package__ankhorage_data_sources --> entrypoint_src_index_ts
-  module_src_ankh_provider_ts["src/ankh.provider.ts"]
-  package__ankhorage_data_sources -.-> module_src_ankh_provider_ts
-  module_src_ankh_provider_ts --> module_src_index_ts
-  module_src_cli_index_ts["src/cli/index.ts"]
-  package__ankhorage_data_sources -.-> module_src_cli_index_ts
-  module_src_discovery_index_ts["src/discovery/index.ts"]
-  package__ankhorage_data_sources -.-> module_src_discovery_index_ts
-  module_src_discovery_index_ts --> module_src_graphql_index_ts
-  module_src_discovery_index_ts --> module_src_openapi_index_ts
-  module_src_generated_api_index_ts["src/generated-api/index.ts"]
-  package__ankhorage_data_sources -.-> module_src_generated_api_index_ts
-  module_src_graphql_index_ts["src/graphql/index.ts"]
-  package__ankhorage_data_sources -.-> module_src_graphql_index_ts
-  module_src_index_ts["src/index.ts"]
-  module_src_openapi_index_ts["src/openapi/index.ts"]
-  package__ankhorage_data_sources -.-> module_src_openapi_index_ts
-  module_src_rest_index_ts["src/rest/index.ts"]
-  package__ankhorage_data_sources -.-> module_src_rest_index_ts
-  module_src_test_runner_index_ts["src/test-runner/index.ts"]
-  package__ankhorage_data_sources -.-> module_src_test_runner_index_ts
-```
-
-</details>
+- [validateManualRestApi sequence](././paradox/diagrams/sequences/validate-manual-rest-api.mmd)

package/dist/ankh.provider.js

@@ -1,4 +1,4 @@
-import { DATA_SOURCES_PACKAGE_NAME, SUPPORTED_DATA_SOURCE_KINDS } from './index';
+import { DATA_SOURCES_PACKAGE_NAME, SUPPORTED_DATA_SOURCE_KINDS } from './packageInfo';
 const DATA_SOURCES_PACKAGE_VERSION = '0.5.1';
 const DATA_SOURCES_COMMAND_CATEGORY = 'data-sources';
 const DATA_SOURCES_CAPABILITIES = [

package/dist/ankh.provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ankh.provider.js","sourceRoot":"","sources":["../src/ankh.provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAEjF,MAAM,4BAA4B,GAAG,OAAO,CAAC;AAC7C,MAAM,6BAA6B,GAAG,cAAc,CAAC;AAErD,MAAM,yBAAyB,GAAG;IAChC,sBAAsB;IACtB,uBAAuB;IACvB,mBAAmB;IACnB,wBAAwB;CAChB,CAAC;AAEX,MAAM,QAAQ,GAAG;IACf;QACE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,mCAAmC;QAC5C,UAAU,EAAE,sBAAsB;QAClC,OAAO,EAAE,CAAC,OAAO,CAAC;QAClB,QAAQ,EAAE,CAAC,6BAA6B,CAAC;KAC1C;IACD;QACE,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC5B,OAAO,EAAE,8DAA8D;QACvE,UAAU,EAAE,uBAAuB;QACnC,QAAQ,EAAE,CAAC,sDAAsD,CAAC;KACnE;IACD;QACE,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,uDAAuD;QAChE,UAAU,EAAE,mBAAmB;QAC/B,QAAQ,EAAE,CAAC,6DAA6D,CAAC;KAC1E;IACD;QACE,IAAI,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC7B,OAAO,EAAE,+CAA+C;QACxD,UAAU,EAAE,wBAAwB;QACpC,QAAQ,EAAE,CAAC,mDAAmD,CAAC;KAChE;CACO,CAAC;AAEX,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,OAAO,CAAC,OAIP;QACC,MAAM,cAAc,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,OAAO,CAAC,OAAO,CAAC,WAAW,CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,yBAAyB,IAAI;YACvE,oBAAoB,cAAc,KAAK,CAC1C,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;CACF,CAAC,CAAC,CAAC;AAEJ,MAAM,QAAQ,GAAG;IACf,EAAE,EAAE,yBAAyB;IAC7B,QAAQ,EAAE,6BAA6B;IACvC,OAAO,EAAE,4BAA4B;IACrC,YAAY,EAAE,yBAAyB;IACvC,QAAQ;IACR,QAAQ;CACT,CAAC;AAEF,eAAe,QAAQ,CAAC","sourcesContent":["import { DATA_SOURCES_PACKAGE_NAME, SUPPORTED_DATA_SOURCE_KINDS } from './index';\n\nconst DATA_SOURCES_PACKAGE_VERSION = '0.5.1';\nconst DATA_SOURCES_COMMAND_CATEGORY = 'data-sources';\n\nconst DATA_SOURCES_CAPABILITIES = [\n  'data-sources.inspect',\n  'data-sources.validate',\n  'data-sources.test',\n  'data-sources.normalize',\n] as const;\n\nconst commands = [\n  {\n    path: ['kind', 'list'],\n    summary: 'List supported data-source kinds.',\n    capability: 'data-sources.inspect',\n    aliases: ['kinds'],\n    examples: ['ankh data-sources kind list'],\n  },\n  {\n    path: ['config', 'validate'],\n    summary: 'Validate a data-source config with the data-sources package.',\n    capability: 'data-sources.validate',\n    examples: ['ankh data-sources config validate ./data-source.json'],\n  },\n  {\n    path: ['endpoint', 'test'],\n    summary: 'Build or execute a data-source endpoint test request.',\n    capability: 'data-sources.test',\n    examples: ['ankh data-sources endpoint test orders listOrders --dry-run'],\n  },\n  {\n    path: ['config', 'normalize'],\n    summary: 'Normalize imported data-source config output.',\n    capability: 'data-sources.normalize',\n    examples: ['ankh data-sources config normalize ./openapi.json'],\n  },\n] as const;\n\nconst handlers = commands.map((command) => ({\n  path: command.path,\n  handler(request: {\n    readonly context: {\n      writeStdout(text: string): void;\n    };\n  }) {\n    const supportedKinds = SUPPORTED_DATA_SOURCE_KINDS.join(', ');\n    request.context.writeStdout(\n      `${command.path.join(' ')} is provided by ${DATA_SOURCES_PACKAGE_NAME}. ` +\n        `Supported kinds: ${supportedKinds}.\\n`,\n    );\n    return { exitCode: 0 };\n  },\n}));\n\nconst provider = {\n  id: DATA_SOURCES_PACKAGE_NAME,\n  category: DATA_SOURCES_COMMAND_CATEGORY,\n  version: DATA_SOURCES_PACKAGE_VERSION,\n  capabilities: DATA_SOURCES_CAPABILITIES,\n  commands,\n  handlers,\n};\n\nexport default provider;\n"]}
+{"version":3,"file":"ankh.provider.js","sourceRoot":"","sources":["../src/ankh.provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAEvF,MAAM,4BAA4B,GAAG,OAAO,CAAC;AAC7C,MAAM,6BAA6B,GAAG,cAAc,CAAC;AAErD,MAAM,yBAAyB,GAAG;IAChC,sBAAsB;IACtB,uBAAuB;IACvB,mBAAmB;IACnB,wBAAwB;CAChB,CAAC;AAEX,MAAM,QAAQ,GAAG;IACf;QACE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,mCAAmC;QAC5C,UAAU,EAAE,sBAAsB;QAClC,OAAO,EAAE,CAAC,OAAO,CAAC;QAClB,QAAQ,EAAE,CAAC,6BAA6B,CAAC;KAC1C;IACD;QACE,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC5B,OAAO,EAAE,8DAA8D;QACvE,UAAU,EAAE,uBAAuB;QACnC,QAAQ,EAAE,CAAC,sDAAsD,CAAC;KACnE;IACD;QACE,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,uDAAuD;QAChE,UAAU,EAAE,mBAAmB;QAC/B,QAAQ,EAAE,CAAC,6DAA6D,CAAC;KAC1E;IACD;QACE,IAAI,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC7B,OAAO,EAAE,+CAA+C;QACxD,UAAU,EAAE,wBAAwB;QACpC,QAAQ,EAAE,CAAC,mDAAmD,CAAC;KAChE;CACO,CAAC;AAEX,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,OAAO,CAAC,OAIP;QACC,MAAM,cAAc,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,OAAO,CAAC,OAAO,CAAC,WAAW,CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,yBAAyB,IAAI;YACvE,oBAAoB,cAAc,KAAK,CAC1C,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;CACF,CAAC,CAAC,CAAC;AAEJ,MAAM,QAAQ,GAAG;IACf,EAAE,EAAE,yBAAyB;IAC7B,QAAQ,EAAE,6BAA6B;IACvC,OAAO,EAAE,4BAA4B;IACrC,YAAY,EAAE,yBAAyB;IACvC,QAAQ;IACR,QAAQ;CACT,CAAC;AAEF,eAAe,QAAQ,CAAC","sourcesContent":["import { DATA_SOURCES_PACKAGE_NAME, SUPPORTED_DATA_SOURCE_KINDS } from './packageInfo';\n\nconst DATA_SOURCES_PACKAGE_VERSION = '0.5.1';\nconst DATA_SOURCES_COMMAND_CATEGORY = 'data-sources';\n\nconst DATA_SOURCES_CAPABILITIES = [\n  'data-sources.inspect',\n  'data-sources.validate',\n  'data-sources.test',\n  'data-sources.normalize',\n] as const;\n\nconst commands = [\n  {\n    path: ['kind', 'list'],\n    summary: 'List supported data-source kinds.',\n    capability: 'data-sources.inspect',\n    aliases: ['kinds'],\n    examples: ['ankh data-sources kind list'],\n  },\n  {\n    path: ['config', 'validate'],\n    summary: 'Validate a data-source config with the data-sources package.',\n    capability: 'data-sources.validate',\n    examples: ['ankh data-sources config validate ./data-source.json'],\n  },\n  {\n    path: ['endpoint', 'test'],\n    summary: 'Build or execute a data-source endpoint test request.',\n    capability: 'data-sources.test',\n    examples: ['ankh data-sources endpoint test orders listOrders --dry-run'],\n  },\n  {\n    path: ['config', 'normalize'],\n    summary: 'Normalize imported data-source config output.',\n    capability: 'data-sources.normalize',\n    examples: ['ankh data-sources config normalize ./openapi.json'],\n  },\n] as const;\n\nconst handlers = commands.map((command) => ({\n  path: command.path,\n  handler(request: {\n    readonly context: {\n      writeStdout(text: string): void;\n    };\n  }) {\n    const supportedKinds = SUPPORTED_DATA_SOURCE_KINDS.join(', ');\n    request.context.writeStdout(\n      `${command.path.join(' ')} is provided by ${DATA_SOURCES_PACKAGE_NAME}. ` +\n        `Supported kinds: ${supportedKinds}.\\n`,\n    );\n    return { exitCode: 0 };\n  },\n}));\n\nconst provider = {\n  id: DATA_SOURCES_PACKAGE_NAME,\n  category: DATA_SOURCES_COMMAND_CATEGORY,\n  version: DATA_SOURCES_PACKAGE_VERSION,\n  capabilities: DATA_SOURCES_CAPABILITIES,\n  commands,\n  handlers,\n};\n\nexport default provider;\n"]}

package/dist/discovery/http.d.ts

@@ -0,0 +1,10 @@
+interface TextResponse {
+    text(): Promise<string>;
+}
+export declare function parseHttpUrl(rawUrl: string): URL | undefined;
+export declare function normalizeCandidateUrl(url: URL): string;
+export declare function isSuccessfulStatus(status: number): boolean;
+export declare function parseJsonResponse(response: TextResponse): Promise<unknown>;
+export declare function readRecord(value: unknown): Readonly<Record<string, unknown>> | undefined;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/discovery/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/discovery/http.ts"],"names":[],"mappings":"AAAA,UAAU,YAAY;IACpB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAS5D;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAItD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAMhF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAIxF"}

package/dist/discovery/http.js

@@ -0,0 +1,35 @@
+export function parseHttpUrl(rawUrl) {
+    try {
+        const parsed = new URL(rawUrl.trim());
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+            return undefined;
+        if (parsed.username.length > 0 || parsed.password.length > 0)
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function normalizeCandidateUrl(url) {
+    const normalized = new URL(url.toString());
+    normalized.hash = '';
+    return normalized.toString();
+}
+export function isSuccessfulStatus(status) {
+    return status >= 200 && status < 300;
+}
+export async function parseJsonResponse(response) {
+    try {
+        return JSON.parse(await response.text());
+    }
+    catch {
+        return undefined;
+    }
+}
+export function readRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+//# sourceMappingURL=http.js.map

package/dist/discovery/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/discovery/http.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAClF,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/E,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAQ;IAC5C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3C,UAAU,CAAC,IAAI,GAAG,EAAE,CAAC;IACrB,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAsB;IAC5D,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAY,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAA2C;QAC9C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC","sourcesContent":["interface TextResponse {\n  text(): Promise<string>;\n}\n\nexport function parseHttpUrl(rawUrl: string): URL | undefined {\n  try {\n    const parsed = new URL(rawUrl.trim());\n    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') return undefined;\n    if (parsed.username.length > 0 || parsed.password.length > 0) return undefined;\n    return parsed;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function normalizeCandidateUrl(url: URL): string {\n  const normalized = new URL(url.toString());\n  normalized.hash = '';\n  return normalized.toString();\n}\n\nexport function isSuccessfulStatus(status: number): boolean {\n  return status >= 200 && status < 300;\n}\n\nexport async function parseJsonResponse(response: TextResponse): Promise<unknown> {\n  try {\n    return JSON.parse(await response.text()) as unknown;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function readRecord(value: unknown): Readonly<Record<string, unknown>> | undefined {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as Readonly<Record<string, unknown>>)\n    : undefined;\n}\n"]}

package/dist/discovery/index.d.ts

@@ -1,4 +1,4 @@
-import type { CredentialRef, DataContractValue, DataSourceDiagnostic, ExternalGraphQlApiDataSourceConfig, ExternalRestApiDataSourceConfig } from '@ankhorage/contracts/data';
+import type { CredentialRef, DataContractValue, DataSourceDiagnostic, ExternalGraphQlApiDefinition, ExternalRestApiDefinition } from '@ankhorage/contracts/data';
 export declare const DEFAULT_OPENAPI_DISCOVERY_PATHS: readonly ["openapi.json", "swagger.json", "api/openapi.json", "v3/api-docs"];
 export interface ExternalApiFetchInit {
     readonly method: 'GET' | 'POST';
@@ -16,7 +16,7 @@ export interface OpenApiDiscoveryAttempt {
     readonly outcome: OpenApiDiscoveryAttemptOutcome;
     readonly status?: number;
 }
-export interface DiscoverOpenApiDataSourceInput {
+export interface DiscoverOpenApiInput {
     readonly id: string;
     readonly url: string;
     readonly fetch: ExternalApiFetch;
@@ -27,9 +27,9 @@ export interface DiscoverOpenApiDataSourceInput {
     readonly metadata?: DataContractValue;
     readonly conventionalPaths?: readonly string[];
 }
-export type DiscoverOpenApiDataSourceResult = {
+export type DiscoverOpenApiResult = {
     readonly ok: true;
-    readonly data: ExternalRestApiDataSourceConfig;
+    readonly data: ExternalRestApiDefinition;
     readonly documentUrl: string;
     readonly attempts: readonly OpenApiDiscoveryAttempt[];
     readonly diagnostics: readonly DataSourceDiagnostic[];
@@ -38,7 +38,7 @@ export type DiscoverOpenApiDataSourceResult = {
     readonly attempts: readonly OpenApiDiscoveryAttempt[];
     readonly diagnostics: readonly DataSourceDiagnostic[];
 };
-export interface IntrospectGraphQlDataSourceInput {
+export interface IntrospectGraphQlApiInput {
     readonly id: string;
     readonly endpointUrl: string;
     readonly fetch: ExternalApiFetch;
@@ -49,9 +49,9 @@ export interface IntrospectGraphQlDataSourceInput {
     readonly schemaVersion?: string;
     readonly metadata?: DataContractValue;
 }
-export type IntrospectGraphQlDataSourceResult = {
+export type IntrospectGraphQlApiResult = {
     readonly ok: true;
-    readonly data: ExternalGraphQlApiDataSourceConfig;
+    readonly data: ExternalGraphQlApiDefinition;
     readonly diagnostics: readonly DataSourceDiagnostic[];
 } | {
     readonly ok: false;
@@ -59,6 +59,6 @@ export type IntrospectGraphQlDataSourceResult = {
     readonly status?: number;
 };
 export declare function createOpenApiDiscoveryCandidates(rawUrl: string, conventionalPaths?: readonly string[]): readonly string[];
-export declare function discoverOpenApiDataSource(input: DiscoverOpenApiDataSourceInput): Promise<DiscoverOpenApiDataSourceResult>;
-export declare function introspectGraphQlDataSource(input: IntrospectGraphQlDataSourceInput): Promise<IntrospectGraphQlDataSourceResult>;
+export declare function discoverOpenApi(input: DiscoverOpenApiInput): Promise<DiscoverOpenApiResult>;
+export declare function introspectGraphQlApi(input: IntrospectGraphQlApiInput): Promise<IntrospectGraphQlApiResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/discovery/index.d.ts.map

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

package/dist/discovery/index.js

@@ -1,5 +1,6 @@
-import { createGraphQlDataSource, createGraphQlIntrospectionRequest, } from '../graphql';
+import { createGraphQlApi, createGraphQlIntrospectionRequest, } from '../graphql';
 import { importOpenApiDocument } from '../openapi';
+import { isSuccessfulStatus, normalizeCandidateUrl, parseHttpUrl, parseJsonResponse, readRecord, } from './http';
 export const DEFAULT_OPENAPI_DISCOVERY_PATHS = [
     'openapi.json',
     'swagger.json',
@@ -22,7 +23,7 @@ export function createOpenApiDiscoveryCandidates(rawUrl, conventionalPaths = DEF
     }
     return [...new Set(candidates)];
 }
-export async function discoverOpenApiDataSource(input) {
+export async function discoverOpenApi(input) {
     const candidates = createOpenApiDiscoveryCandidates(input.url, input.conventionalPaths);
     if (candidates.length === 0) {
         return discoveryFailure(input.id, [], 'OpenAPI discovery requires a valid HTTP or HTTPS URL.');
@@ -45,24 +46,13 @@ export async function discoverOpenApiDataSource(input) {
     }
     return discoveryFailure(input.id, attempts, 'No supported OpenAPI document was found at the supplied URL or conventional locations.');
 }
-export async function introspectGraphQlDataSource(input) {
+export async function introspectGraphQlApi(input) {
     const endpoint = parseHttpUrl(input.endpointUrl);
     if (endpoint === undefined) {
         return graphqlFailure(input.id, 'GraphQL introspection requires a valid HTTP or HTTPS URL.');
     }
-    let response;
-    try {
-        response = await input.fetch(normalizeCandidateUrl(endpoint), {
-            method: 'POST',
-            headers: {
-                accept: 'application/json',
-                'content-type': 'application/json',
-                ...(input.headers ?? {}),
-            },
-            body: JSON.stringify(createGraphQlIntrospectionRequest()),
-        });
-    }
-    catch {
+    const response = await fetchGraphQlIntrospection(input, endpoint);
+    if (response === undefined) {
         return graphqlFailure(input.id, 'GraphQL introspection request failed.', 'network-error');
     }
     if (!isSuccessfulStatus(response.status)) {
@@ -75,7 +65,7 @@ export async function introspectGraphQlDataSource(input) {
     if (introspection === undefined) {
         return graphqlFailure(input.id, 'GraphQL introspection response did not contain data.__schema.', 'parse-error');
     }
-    const result = createGraphQlDataSource({
+    const result = createGraphQlApi({
         id: input.id,
         endpointUrl: normalizeCandidateUrl(endpoint),
         credential: input.credential,
@@ -90,6 +80,22 @@ export async function introspectGraphQlDataSource(input) {
         ? { ok: true, data: result.data, diagnostics: result.diagnostics ?? [] }
         : { ok: false, diagnostics: result.diagnostics };
 }
+async function fetchGraphQlIntrospection(input, endpoint) {
+    try {
+        return await input.fetch(normalizeCandidateUrl(endpoint), {
+            method: 'POST',
+            headers: {
+                accept: 'application/json',
+                'content-type': 'application/json',
+                ...(input.headers ?? {}),
+            },
+            body: JSON.stringify(createGraphQlIntrospectionRequest()),
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
 async function probeOpenApiCandidate(input, candidate) {
     let response;
     try {
@@ -132,35 +138,6 @@ async function probeOpenApiCandidate(input, candidate) {
         result,
     };
 }
-function parseHttpUrl(rawUrl) {
-    try {
-        const parsed = new URL(rawUrl.trim());
-        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
-            return undefined;
-        if (parsed.username.length > 0 || parsed.password.length > 0)
-            return undefined;
-        return parsed;
-    }
-    catch {
-        return undefined;
-    }
-}
-function normalizeCandidateUrl(url) {
-    const normalized = new URL(url.toString());
-    normalized.hash = '';
-    return normalized.toString();
-}
-function isSuccessfulStatus(status) {
-    return status >= 200 && status < 300;
-}
-async function parseJsonResponse(response) {
-    try {
-        return JSON.parse(await response.text());
-    }
-    catch {
-        return undefined;
-    }
-}
 function isOpenApiDocument(value) {
     const record = readRecord(value);
     return (record !== undefined &&
@@ -174,22 +151,17 @@ function readGraphQlIntrospection(value) {
         return undefined;
     return data;
 }
-function readRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value)
-        ? value
-        : undefined;
-}
-function discoveryFailure(dataSourceId, attempts, message) {
+function discoveryFailure(apiId, attempts, message) {
     return {
         ok: false,
         attempts,
-        diagnostics: [{ code: 'missing-schema', dataSourceId, message, severity: 'error' }],
+        diagnostics: [{ code: 'missing-schema', apiId, message, severity: 'error' }],
     };
 }
-function graphqlFailure(dataSourceId, message, code = 'invalid-config') {
+function graphqlFailure(apiId, message, code = 'invalid-config') {
     return {
         ok: false,
-        diagnostics: [{ code, dataSourceId, message, severity: 'error' }],
+        diagnostics: [{ code, apiId, message, severity: 'error' }],
     };
 }
 //# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CredentialRef,\n  DataContractValue,\n  DataSourceDiagnostic,\n  ExternalGraphQlApiDataSourceConfig,\n  ExternalRestApiDataSourceConfig,\n} from '@ankhorage/contracts/data';\n\nimport {\n  createGraphQlDataSource,\n  createGraphQlIntrospectionRequest,\n  type GraphQlIntrospectionResult,\n} from '../graphql';\nimport { importOpenApiDocument, type OpenApiDocumentObject } from '../openapi';\n\nexport const DEFAULT_OPENAPI_DISCOVERY_PATHS = [\n  'openapi.json',\n  'swagger.json',\n  'api/openapi.json',\n  'v3/api-docs',\n] as const;\n\nexport interface ExternalApiFetchInit {\n  readonly method: 'GET' | 'POST';\n  readonly headers: Readonly<Record<string, string>>;\n  readonly body?: string;\n}\n\nexport interface ExternalApiFetchResponse {\n  readonly status: number;\n  text(): Promise<string>;\n}\n\nexport type ExternalApiFetch = (\n  url: string,\n  init: ExternalApiFetchInit,\n) => Promise<ExternalApiFetchResponse>;\n\nexport type OpenApiDiscoveryAttemptOutcome =\n  | 'http-error'\n  | 'invalid-document'\n  | 'matched'\n  | 'network-error'\n  | 'parse-error'\n  | 'unsupported-document';\n\nexport interface OpenApiDiscoveryAttempt {\n  readonly url: string;\n  readonly outcome: OpenApiDiscoveryAttemptOutcome;\n  readonly status?: number;\n}\n\nexport interface DiscoverOpenApiDataSourceInput {\n  readonly id: string;\n  readonly url: string;\n  readonly fetch: ExternalApiFetch;\n  readonly baseUrl?: string;\n  readonly credential?: CredentialRef;\n  readonly name?: string;\n  readonly description?: string;\n  readonly metadata?: DataContractValue;\n  readonly conventionalPaths?: readonly string[];\n}\n\nexport type DiscoverOpenApiDataSourceResult =\n  | {\n      readonly ok: true;\n      readonly data: ExternalRestApiDataSourceConfig;\n      readonly documentUrl: string;\n      readonly attempts: readonly OpenApiDiscoveryAttempt[];\n      readonly diagnostics: readonly DataSourceDiagnostic[];\n    }\n  | {\n      readonly ok: false;\n      readonly attempts: readonly OpenApiDiscoveryAttempt[];\n      readonly diagnostics: readonly DataSourceDiagnostic[];\n    };\n\nexport interface IntrospectGraphQlDataSourceInput {\n  readonly id: string;\n  readonly endpointUrl: string;\n  readonly fetch: ExternalApiFetch;\n  readonly headers?: Readonly<Record<string, string>>;\n  readonly credential?: CredentialRef;\n  readonly name?: string;\n  readonly description?: string;\n  readonly schemaVersion?: string;\n  readonly metadata?: DataContractValue;\n}\n\nexport type IntrospectGraphQlDataSourceResult =\n  | {\n      readonly ok: true;\n      readonly data: ExternalGraphQlApiDataSourceConfig;\n      readonly diagnostics: readonly DataSourceDiagnostic[];\n    }\n  | {\n      readonly ok: false;\n      readonly diagnostics: readonly DataSourceDiagnostic[];\n      readonly status?: number;\n    };\n\nexport function createOpenApiDiscoveryCandidates(\n  rawUrl: string,\n  conventionalPaths: readonly string[] = DEFAULT_OPENAPI_DISCOVERY_PATHS,\n): readonly string[] {\n  const parsed = parseHttpUrl(rawUrl);\n  if (parsed === undefined) return [];\n\n  const exact = normalizeCandidateUrl(parsed);\n  const serviceBase = new URL(exact);\n  if (!serviceBase.pathname.endsWith('/')) serviceBase.pathname = `${serviceBase.pathname}/`;\n\n  const candidates = [exact];\n  for (const path of conventionalPaths) {\n    const normalizedPath = path.replace(/^\\/+/, '');\n    candidates.push(normalizeCandidateUrl(new URL(normalizedPath, serviceBase)));\n    candidates.push(normalizeCandidateUrl(new URL(normalizedPath, `${parsed.origin}/`)));\n  }\n\n  return [...new Set(candidates)];\n}\n\nexport async function discoverOpenApiDataSource(\n  input: DiscoverOpenApiDataSourceInput,\n): Promise<DiscoverOpenApiDataSourceResult> {\n  const candidates = createOpenApiDiscoveryCandidates(input.url, input.conventionalPaths);\n  if (candidates.length === 0) {\n    return discoveryFailure(input.id, [], 'OpenAPI discovery requires a valid HTTP or HTTPS URL.');\n  }\n\n  const attempts: OpenApiDiscoveryAttempt[] = [];\n  for (const candidate of candidates) {\n    const probed = await probeOpenApiCandidate(input, candidate);\n    attempts.push(probed.attempt);\n    if (probed.result === undefined) continue;\n    return probed.result.ok\n      ? {\n          ok: true,\n          data: probed.result.data,\n          documentUrl: candidate,\n          attempts,\n          diagnostics: probed.result.diagnostics ?? [],\n        }\n      : { ok: false, attempts, diagnostics: probed.result.diagnostics };\n  }\n\n  return discoveryFailure(\n    input.id,\n    attempts,\n    'No supported OpenAPI document was found at the supplied URL or conventional locations.',\n  );\n}\n\nexport async function introspectGraphQlDataSource(\n  input: IntrospectGraphQlDataSourceInput,\n): Promise<IntrospectGraphQlDataSourceResult> {\n  const endpoint = parseHttpUrl(input.endpointUrl);\n  if (endpoint === undefined) {\n    return graphqlFailure(input.id, 'GraphQL introspection requires a valid HTTP or HTTPS URL.');\n  }\n\n  let response: ExternalApiFetchResponse;\n  try {\n    response = await input.fetch(normalizeCandidateUrl(endpoint), {\n      method: 'POST',\n      headers: {\n        accept: 'application/json',\n        'content-type': 'application/json',\n        ...(input.headers ?? {}),\n      },\n      body: JSON.stringify(createGraphQlIntrospectionRequest()),\n    });\n  } catch {\n    return graphqlFailure(input.id, 'GraphQL introspection request failed.', 'network-error');\n  }\n\n  if (!isSuccessfulStatus(response.status)) {\n    return {\n      ...graphqlFailure(\n        input.id,\n        `GraphQL introspection returned HTTP status ${response.status}.`,\n        'network-error',\n      ),\n      status: response.status,\n    };\n  }\n\n  const introspection = readGraphQlIntrospection(await parseJsonResponse(response));\n  if (introspection === undefined) {\n    return graphqlFailure(\n      input.id,\n      'GraphQL introspection response did not contain data.__schema.',\n      'parse-error',\n    );\n  }\n\n  const result = createGraphQlDataSource({\n    id: input.id,\n    endpointUrl: normalizeCandidateUrl(endpoint),\n    credential: input.credential,\n    name: input.name,\n    description: input.description,\n    introspection,\n    introspectionEnabled: true,\n    schemaVersion: input.schemaVersion,\n    metadata: input.metadata,\n  });\n\n  return result.ok\n    ? { ok: true, data: result.data, diagnostics: result.diagnostics ?? [] }\n    : { ok: false, diagnostics: result.diagnostics };\n}\n\ninterface OpenApiProbeResult {\n  readonly attempt: OpenApiDiscoveryAttempt;\n  readonly result?: ReturnType<typeof importOpenApiDocument>;\n}\n\nasync function probeOpenApiCandidate(\n  input: DiscoverOpenApiDataSourceInput,\n  candidate: string,\n): Promise<OpenApiProbeResult> {\n  let response: ExternalApiFetchResponse;\n  try {\n    response = await input.fetch(candidate, {\n      method: 'GET',\n      headers: { accept: 'application/json, application/vnd.oai.openapi+json' },\n    });\n  } catch {\n    return { attempt: { url: candidate, outcome: 'network-error' } };\n  }\n\n  if (!isSuccessfulStatus(response.status)) {\n    return { attempt: { url: candidate, outcome: 'http-error', status: response.status } };\n  }\n\n  const parsed = await parseJsonResponse(response);\n  if (parsed === undefined) {\n    return { attempt: { url: candidate, outcome: 'parse-error', status: response.status } };\n  }\n  if (!isOpenApiDocument(parsed)) {\n    return {\n      attempt: { url: candidate, outcome: 'unsupported-document', status: response.status },\n    };\n  }\n\n  const result = importOpenApiDocument({\n    id: input.id,\n    document: parsed,\n    baseUrl: input.baseUrl,\n    credential: input.credential,\n    documentUrl: candidate,\n    name: input.name,\n    description: input.description,\n    metadata: input.metadata,\n  });\n  return {\n    attempt: {\n      url: candidate,\n      outcome: result.ok ? 'matched' : 'invalid-document',\n      status: response.status,\n    },\n    result,\n  };\n}\n\nfunction parseHttpUrl(rawUrl: string): URL | undefined {\n  try {\n    const parsed = new URL(rawUrl.trim());\n    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') return undefined;\n    if (parsed.username.length > 0 || parsed.password.length > 0) return undefined;\n    return parsed;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction normalizeCandidateUrl(url: URL): string {\n  const normalized = new URL(url.toString());\n  normalized.hash = '';\n  return normalized.toString();\n}\n\nfunction isSuccessfulStatus(status: number): boolean {\n  return status >= 200 && status < 300;\n}\n\nasync function parseJsonResponse(response: ExternalApiFetchResponse): Promise<unknown> {\n  try {\n    return JSON.parse(await response.text()) as unknown;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction isOpenApiDocument(value: unknown): value is OpenApiDocumentObject {\n  const record = readRecord(value);\n  return (\n    record !== undefined &&\n    typeof record.openapi === 'string' &&\n    readRecord(record.paths) !== undefined\n  );\n}\n\nfunction readGraphQlIntrospection(value: unknown): GraphQlIntrospectionResult | undefined {\n  const payload = readRecord(value);\n  const data = readRecord(payload?.data);\n  if (readRecord(data?.__schema) === undefined) return undefined;\n  return data;\n}\n\nfunction readRecord(value: unknown): Readonly<Record<string, unknown>> | undefined {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as Readonly<Record<string, unknown>>)\n    : undefined;\n}\n\nfunction discoveryFailure(\n  dataSourceId: string,\n  attempts: readonly OpenApiDiscoveryAttempt[],\n  message: string,\n): DiscoverOpenApiDataSourceResult {\n  return {\n    ok: false,\n    attempts,\n    diagnostics: [{ code: 'missing-schema', dataSourceId, message, severity: 'error' }],\n  };\n}\n\nfunction graphqlFailure(\n  dataSourceId: string,\n  message: string,\n  code: DataSourceDiagnostic['code'] = 'invalid-config',\n): Extract<IntrospectGraphQlDataSourceResult, { readonly ok: false }> {\n  return {\n    ok: false,\n    diagnostics: [{ code, dataSourceId, message, severity: 'error' }],\n  };\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CredentialRef,\n  DataContractValue,\n  DataSourceDiagnostic,\n  ExternalGraphQlApiDefinition,\n  ExternalRestApiDefinition,\n} from '@ankhorage/contracts/data';\n\nimport {\n  createGraphQlApi,\n  createGraphQlIntrospectionRequest,\n  type GraphQlIntrospectionResult,\n} from '../graphql';\nimport { importOpenApiDocument, type OpenApiDocumentObject } from '../openapi';\nimport {\n  isSuccessfulStatus,\n  normalizeCandidateUrl,\n  parseHttpUrl,\n  parseJsonResponse,\n  readRecord,\n} from './http';\n\nexport const DEFAULT_OPENAPI_DISCOVERY_PATHS = [\n  'openapi.json',\n  'swagger.json',\n  'api/openapi.json',\n  'v3/api-docs',\n] as const;\n\nexport interface ExternalApiFetchInit {\n  readonly method: 'GET' | 'POST';\n  readonly headers: Readonly<Record<string, string>>;\n  readonly body?: string;\n}\n\nexport interface ExternalApiFetchResponse {\n  readonly status: number;\n  text(): Promise<string>;\n}\n\nexport type ExternalApiFetch = (\n  url: string,\n  init: ExternalApiFetchInit,\n) => Promise<ExternalApiFetchResponse>;\n\nexport type OpenApiDiscoveryAttemptOutcome =\n  | 'http-error'\n  | 'invalid-document'\n  | 'matched'\n  | 'network-error'\n  | 'parse-error'\n  | 'unsupported-document';\n\nexport interface OpenApiDiscoveryAttempt {\n  readonly url: string;\n  readonly outcome: OpenApiDiscoveryAttemptOutcome;\n  readonly status?: number;\n}\n\nexport interface DiscoverOpenApiInput {\n  readonly id: string;\n  readonly url: string;\n  readonly fetch: ExternalApiFetch;\n  readonly baseUrl?: string;\n  readonly credential?: CredentialRef;\n  readonly name?: string;\n  readonly description?: string;\n  readonly metadata?: DataContractValue;\n  readonly conventionalPaths?: readonly string[];\n}\n\nexport type DiscoverOpenApiResult =\n  | {\n      readonly ok: true;\n      readonly data: ExternalRestApiDefinition;\n      readonly documentUrl: string;\n      readonly attempts: readonly OpenApiDiscoveryAttempt[];\n      readonly diagnostics: readonly DataSourceDiagnostic[];\n    }\n  | {\n      readonly ok: false;\n      readonly attempts: readonly OpenApiDiscoveryAttempt[];\n      readonly diagnostics: readonly DataSourceDiagnostic[];\n    };\n\nexport interface IntrospectGraphQlApiInput {\n  readonly id: string;\n  readonly endpointUrl: string;\n  readonly fetch: ExternalApiFetch;\n  readonly headers?: Readonly<Record<string, string>>;\n  readonly credential?: CredentialRef;\n  readonly name?: string;\n  readonly description?: string;\n  readonly schemaVersion?: string;\n  readonly metadata?: DataContractValue;\n}\n\nexport type IntrospectGraphQlApiResult =\n  | {\n      readonly ok: true;\n      readonly data: ExternalGraphQlApiDefinition;\n      readonly diagnostics: readonly DataSourceDiagnostic[];\n    }\n  | {\n      readonly ok: false;\n      readonly diagnostics: readonly DataSourceDiagnostic[];\n      readonly status?: number;\n    };\n\nexport function createOpenApiDiscoveryCandidates(\n  rawUrl: string,\n  conventionalPaths: readonly string[] = DEFAULT_OPENAPI_DISCOVERY_PATHS,\n): readonly string[] {\n  const parsed = parseHttpUrl(rawUrl);\n  if (parsed === undefined) return [];\n\n  const exact = normalizeCandidateUrl(parsed);\n  const serviceBase = new URL(exact);\n  if (!serviceBase.pathname.endsWith('/')) serviceBase.pathname = `${serviceBase.pathname}/`;\n\n  const candidates = [exact];\n  for (const path of conventionalPaths) {\n    const normalizedPath = path.replace(/^\\/+/, '');\n    candidates.push(normalizeCandidateUrl(new URL(normalizedPath, serviceBase)));\n    candidates.push(normalizeCandidateUrl(new URL(normalizedPath, `${parsed.origin}/`)));\n  }\n\n  return [...new Set(candidates)];\n}\n\nexport async function discoverOpenApi(input: DiscoverOpenApiInput): Promise<DiscoverOpenApiResult> {\n  const candidates = createOpenApiDiscoveryCandidates(input.url, input.conventionalPaths);\n  if (candidates.length === 0) {\n    return discoveryFailure(input.id, [], 'OpenAPI discovery requires a valid HTTP or HTTPS URL.');\n  }\n\n  const attempts: OpenApiDiscoveryAttempt[] = [];\n  for (const candidate of candidates) {\n    const probed = await probeOpenApiCandidate(input, candidate);\n    attempts.push(probed.attempt);\n    if (probed.result === undefined) continue;\n    return probed.result.ok\n      ? {\n          ok: true,\n          data: probed.result.data,\n          documentUrl: candidate,\n          attempts,\n          diagnostics: probed.result.diagnostics ?? [],\n        }\n      : { ok: false, attempts, diagnostics: probed.result.diagnostics };\n  }\n\n  return discoveryFailure(\n    input.id,\n    attempts,\n    'No supported OpenAPI document was found at the supplied URL or conventional locations.',\n  );\n}\n\nexport async function introspectGraphQlApi(\n  input: IntrospectGraphQlApiInput,\n): Promise<IntrospectGraphQlApiResult> {\n  const endpoint = parseHttpUrl(input.endpointUrl);\n  if (endpoint === undefined) {\n    return graphqlFailure(input.id, 'GraphQL introspection requires a valid HTTP or HTTPS URL.');\n  }\n\n  const response = await fetchGraphQlIntrospection(input, endpoint);\n  if (response === undefined) {\n    return graphqlFailure(input.id, 'GraphQL introspection request failed.', 'network-error');\n  }\n  if (!isSuccessfulStatus(response.status)) {\n    return {\n      ...graphqlFailure(\n        input.id,\n        `GraphQL introspection returned HTTP status ${response.status}.`,\n        'network-error',\n      ),\n      status: response.status,\n    };\n  }\n\n  const introspection = readGraphQlIntrospection(await parseJsonResponse(response));\n  if (introspection === undefined) {\n    return graphqlFailure(\n      input.id,\n      'GraphQL introspection response did not contain data.__schema.',\n      'parse-error',\n    );\n  }\n\n  const result = createGraphQlApi({\n    id: input.id,\n    endpointUrl: normalizeCandidateUrl(endpoint),\n    credential: input.credential,\n    name: input.name,\n    description: input.description,\n    introspection,\n    introspectionEnabled: true,\n    schemaVersion: input.schemaVersion,\n    metadata: input.metadata,\n  });\n  return result.ok\n    ? { ok: true, data: result.data, diagnostics: result.diagnostics ?? [] }\n    : { ok: false, diagnostics: result.diagnostics };\n}\n\nasync function fetchGraphQlIntrospection(\n  input: IntrospectGraphQlApiInput,\n  endpoint: URL,\n): Promise<ExternalApiFetchResponse | undefined> {\n  try {\n    return await input.fetch(normalizeCandidateUrl(endpoint), {\n      method: 'POST',\n      headers: {\n        accept: 'application/json',\n        'content-type': 'application/json',\n        ...(input.headers ?? {}),\n      },\n      body: JSON.stringify(createGraphQlIntrospectionRequest()),\n    });\n  } catch {\n    return undefined;\n  }\n}\n\ninterface OpenApiProbeResult {\n  readonly attempt: OpenApiDiscoveryAttempt;\n  readonly result?: ReturnType<typeof importOpenApiDocument>;\n}\n\nasync function probeOpenApiCandidate(\n  input: DiscoverOpenApiInput,\n  candidate: string,\n): Promise<OpenApiProbeResult> {\n  let response: ExternalApiFetchResponse;\n  try {\n    response = await input.fetch(candidate, {\n      method: 'GET',\n      headers: { accept: 'application/json, application/vnd.oai.openapi+json' },\n    });\n  } catch {\n    return { attempt: { url: candidate, outcome: 'network-error' } };\n  }\n\n  if (!isSuccessfulStatus(response.status)) {\n    return { attempt: { url: candidate, outcome: 'http-error', status: response.status } };\n  }\n\n  const parsed = await parseJsonResponse(response);\n  if (parsed === undefined) {\n    return { attempt: { url: candidate, outcome: 'parse-error', status: response.status } };\n  }\n  if (!isOpenApiDocument(parsed)) {\n    return {\n      attempt: { url: candidate, outcome: 'unsupported-document', status: response.status },\n    };\n  }\n\n  const result = importOpenApiDocument({\n    id: input.id,\n    document: parsed,\n    baseUrl: input.baseUrl,\n    credential: input.credential,\n    documentUrl: candidate,\n    name: input.name,\n    description: input.description,\n    metadata: input.metadata,\n  });\n  return {\n    attempt: {\n      url: candidate,\n      outcome: result.ok ? 'matched' : 'invalid-document',\n      status: response.status,\n    },\n    result,\n  };\n}\n\nfunction isOpenApiDocument(value: unknown): value is OpenApiDocumentObject {\n  const record = readRecord(value);\n  return (\n    record !== undefined &&\n    typeof record.openapi === 'string' &&\n    readRecord(record.paths) !== undefined\n  );\n}\n\nfunction readGraphQlIntrospection(value: unknown): GraphQlIntrospectionResult | undefined {\n  const payload = readRecord(value);\n  const data = readRecord(payload?.data);\n  if (readRecord(data?.__schema) === undefined) return undefined;\n  return data;\n}\n\nfunction discoveryFailure(\n  apiId: string,\n  attempts: readonly OpenApiDiscoveryAttempt[],\n  message: string,\n): DiscoverOpenApiResult {\n  return {\n    ok: false,\n    attempts,\n    diagnostics: [{ code: 'missing-schema', apiId, message, severity: 'error' }],\n  };\n}\n\nfunction graphqlFailure(\n  apiId: string,\n  message: string,\n  code: DataSourceDiagnostic['code'] = 'invalid-config',\n): Extract<IntrospectGraphQlApiResult, { readonly ok: false }> {\n  return {\n    ok: false,\n    diagnostics: [{ code, apiId, message, severity: 'error' }],\n  };\n}\n"]}

package/dist/graphql/index.d.ts

@@ -1,83 +1,15 @@
-import type { CredentialRef, DataContractValue, DataSchema, DataSchemaRegistry, DataSourceDiagnostic, DataSourceDiagnosticResult, ExternalGraphQlApiDataSourceConfig, OperationId } from '@ankhorage/contracts/data';
+import type { DataSourceDiagnostic, DataSourceDiagnosticResult, ExternalGraphQlApiDefinition } from '@ankhorage/contracts/data';
+import type { GraphQlApiDefinition } from './types';
+export { normalizeGraphQlIntrospectionOperations, normalizeGraphQlIntrospectionSchemas, } from './introspection';
+export { normalizeGraphQlOperationId } from './operation';
+export type * from './types';
 export declare const GRAPHQL_INTROSPECTION_QUERY = "query AnkhorageGraphQlIntrospection {\n  __schema {\n    queryType { name }\n    mutationType { name }\n    subscriptionType { name }\n    types {\n      kind\n      name\n      description\n      fields {\n        name\n        description\n        args {\n          name\n          description\n          type { kind name ofType { kind name ofType { kind name ofType { kind name } } } }\n          defaultValue\n        }\n        type { kind name ofType { kind name ofType { kind name ofType { kind name } } } }\n      }\n      inputFields {\n        name\n        description\n        type { kind name ofType { kind name ofType { kind name ofType { kind name } } } }\n        defaultValue\n      }\n      enumValues { name description }\n      possibleTypes { kind name }\n    }\n  }\n}";
-export type GraphQlOperationKind = 'mutation' | 'query' | 'subscription';
-export interface GraphQlIntrospectionTypeRef {
-    readonly kind: string;
-    readonly name?: string | null;
-    readonly ofType?: GraphQlIntrospectionTypeRef | null;
-}
-export interface GraphQlIntrospectionInputValue {
-    readonly name: string;
-    readonly description?: string | null;
-    readonly type: GraphQlIntrospectionTypeRef;
-    readonly defaultValue?: string | null;
-}
-export interface GraphQlIntrospectionField {
-    readonly name: string;
-    readonly description?: string | null;
-    readonly args?: readonly GraphQlIntrospectionInputValue[] | null;
-    readonly type: GraphQlIntrospectionTypeRef;
-}
-export interface GraphQlIntrospectionEnumValue {
-    readonly name: string;
-    readonly description?: string | null;
-}
-export interface GraphQlIntrospectionType {
-    readonly kind: string;
-    readonly name?: string | null;
-    readonly description?: string | null;
-    readonly fields?: readonly GraphQlIntrospectionField[] | null;
-    readonly inputFields?: readonly GraphQlIntrospectionInputValue[] | null;
-    readonly enumValues?: readonly GraphQlIntrospectionEnumValue[] | null;
-    readonly possibleTypes?: readonly GraphQlIntrospectionTypeRef[] | null;
-}
-export interface GraphQlIntrospectionSchema {
-    readonly queryType?: {
-        readonly name?: string | null;
-    } | null;
-    readonly mutationType?: {
-        readonly name?: string | null;
-    } | null;
-    readonly subscriptionType?: {
-        readonly name?: string | null;
-    } | null;
-    readonly types?: readonly GraphQlIntrospectionType[] | null;
-}
-export interface GraphQlIntrospectionResult {
-    readonly __schema?: GraphQlIntrospectionSchema;
-}
-export interface GraphQlOperationDefinition {
-    readonly id: OperationId;
-    readonly kind: GraphQlOperationKind;
-    readonly name?: string;
-    readonly description?: string;
-    readonly document?: string;
-    readonly variables?: DataSchema;
-    readonly response?: DataSchema;
-    readonly selectionPath?: string;
-    readonly metadata?: DataContractValue;
-}
-export interface GraphQlDataSourceDefinition {
-    readonly id: string;
-    readonly endpointUrl: string;
-    readonly name?: string;
-    readonly description?: string;
-    readonly credential?: CredentialRef;
-    readonly introspection?: GraphQlIntrospectionResult;
-    readonly introspectionEnabled?: boolean;
-    readonly schemaVersion?: string;
-    readonly operations?: readonly GraphQlOperationDefinition[];
-    readonly metadata?: DataContractValue;
-}
 export interface GraphQlIntrospectionRequest {
     readonly query: typeof GRAPHQL_INTROSPECTION_QUERY;
     readonly operationName: 'AnkhorageGraphQlIntrospection';
 }
 export declare function createGraphQlIntrospectionRequest(): GraphQlIntrospectionRequest;
-export declare function normalizeGraphQlOperationId(kind: GraphQlOperationKind, name: string): OperationId;
-export declare function createGraphQlDataSource(definition: GraphQlDataSourceDefinition): DataSourceDiagnosticResult<ExternalGraphQlApiDataSourceConfig>;
-export declare function validateGraphQlDataSource(definition: GraphQlDataSourceDefinition): readonly DataSourceDiagnostic[];
-export declare function normalizeGraphQlDataSource(definition: GraphQlDataSourceDefinition): ExternalGraphQlApiDataSourceConfig;
-export declare function normalizeGraphQlIntrospectionSchemas(introspection: GraphQlIntrospectionResult | undefined): DataSchemaRegistry | undefined;
-export declare function normalizeGraphQlIntrospectionOperations(introspection: GraphQlIntrospectionResult | undefined): readonly GraphQlOperationDefinition[];
+export declare function createGraphQlApi(definition: GraphQlApiDefinition): DataSourceDiagnosticResult<ExternalGraphQlApiDefinition>;
+export declare function validateGraphQlApi(definition: GraphQlApiDefinition): readonly DataSourceDiagnostic[];
+export declare function normalizeGraphQlApi(definition: GraphQlApiDefinition): ExternalGraphQlApiDefinition;
 //# sourceMappingURL=index.d.ts.map

package/dist/graphql/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graphql/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graphql/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,2BAA2B,CAAC;AAOnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,OAAO,EACL,uCAAuC,EACvC,oCAAoC,GACrC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,mBAAmB,SAAS,CAAC;AAE7B,eAAO,MAAM,2BAA2B,2xBA8BtC,CAAC;AAEH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,OAAO,2BAA2B,CAAC;IACnD,QAAQ,CAAC,aAAa,EAAE,+BAA+B,CAAC;CACzD;AAED,wBAAgB,iCAAiC,IAAI,2BAA2B,CAK/E;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,oBAAoB,GAC/B,0BAA0B,CAAC,4BAA4B,CAAC,CAM1D;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,oBAAoB,GAC/B,SAAS,oBAAoB,EAAE,CAgCjC;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,oBAAoB,GAC/B,4BAA4B,CAgC9B"}