@ankhorage/data-sources 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ankhorage
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+<!-- markdownlint-disable MD013 MD033 -->
+<!-- This file is generated by Paradox. Do not edit manually. -->
+
+# @ankhorage/data-sources
+
+![license: MIT](././paradox/badges/license.svg) ![npm: v0.0.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)
+
+Provider-neutral data source and endpoint system for APIs, databases, and runtime bindings.
+
+## Generated documentation
+
+- [Interactive documentation app](././paradox/index.html)
+- [Public API reference](././paradox/exports.md)
+- [Component registry](././paradox/components.md)
+- [Architecture overview](././paradox/diagrams/architecture-overview.mmd)
+- [Module relationships](././paradox/diagrams/module-relationships.mmd)
+- [Export graph](././paradox/diagrams/export-graph.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_index_ts["src/index.ts"]
+```
+
+</details>

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { DataSourceConfig, DataSourceKind } from '@ankhorage/contracts/data';
+export declare const DATA_SOURCES_PACKAGE_NAME: "@ankhorage/data-sources";
+export declare const SUPPORTED_DATA_SOURCE_KINDS: readonly ["database", "graphql", "managed-api", "openapi", "rest"];
+export interface DataSourcesPackageInfo {
+    readonly packageName: typeof DATA_SOURCES_PACKAGE_NAME;
+    readonly supportedKinds: typeof SUPPORTED_DATA_SOURCE_KINDS;
+}
+export declare function getDataSourcesPackageInfo(): DataSourcesPackageInfo;
+export declare function isSupportedDataSourceKind(kind: string): kind is DataSourceKind;
+export declare function getDataSourceKind(source: DataSourceConfig): DataSourceKind;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAElF,eAAO,MAAM,yBAAyB,EAAG,yBAAkC,CAAC;AAE5E,eAAO,MAAM,2BAA2B,oEAMM,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,yBAAyB,CAAC;IACvD,QAAQ,CAAC,cAAc,EAAE,OAAO,2BAA2B,CAAC;CAC7D;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,CAKlE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,cAAc,CAE9E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAE1E"}

package/dist/index.js

@@ -0,0 +1,21 @@
+export const DATA_SOURCES_PACKAGE_NAME = '@ankhorage/data-sources';
+export const SUPPORTED_DATA_SOURCE_KINDS = [
+    'database',
+    'graphql',
+    'managed-api',
+    'openapi',
+    'rest',
+];
+export function getDataSourcesPackageInfo() {
+    return {
+        packageName: DATA_SOURCES_PACKAGE_NAME,
+        supportedKinds: SUPPORTED_DATA_SOURCE_KINDS,
+    };
+}
+export function isSupportedDataSourceKind(kind) {
+    return SUPPORTED_DATA_SOURCE_KINDS.some((supportedKind) => supportedKind === kind);
+}
+export function getDataSourceKind(source) {
+    return source.kind;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,yBAAyB,GAAG,yBAAkC,CAAC;AAE5E,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,UAAU;IACV,SAAS;IACT,aAAa;IACb,SAAS;IACT,MAAM;CACsC,CAAC;AAO/C,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,WAAW,EAAE,yBAAyB;QACtC,cAAc,EAAE,2BAA2B;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC","sourcesContent":["import type { DataSourceConfig, DataSourceKind } from '@ankhorage/contracts/data';\n\nexport const DATA_SOURCES_PACKAGE_NAME = '@ankhorage/data-sources' as const;\n\nexport const SUPPORTED_DATA_SOURCE_KINDS = [\n  'database',\n  'graphql',\n  'managed-api',\n  'openapi',\n  'rest',\n] as const satisfies readonly DataSourceKind[];\n\nexport interface DataSourcesPackageInfo {\n  readonly packageName: typeof DATA_SOURCES_PACKAGE_NAME;\n  readonly supportedKinds: typeof SUPPORTED_DATA_SOURCE_KINDS;\n}\n\nexport function getDataSourcesPackageInfo(): DataSourcesPackageInfo {\n  return {\n    packageName: DATA_SOURCES_PACKAGE_NAME,\n    supportedKinds: SUPPORTED_DATA_SOURCE_KINDS,\n  };\n}\n\nexport function isSupportedDataSourceKind(kind: string): kind is DataSourceKind {\n  return SUPPORTED_DATA_SOURCE_KINDS.some((supportedKind) => supportedKind === kind);\n}\n\nexport function getDataSourceKind(source: DataSourceConfig): DataSourceKind {\n  return source.kind;\n}\n"]}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@ankhorage/data-sources",
+  "type": "module",
+  "version": "0.0.0",
+  "description": "Headless toolkit for importing, generating, normalizing, and testing Ankhorage data-source configs.",
+  "homepage": "https://github.com/ankhorage/data-sources#readme",
+  "bugs": {
+    "url": "https://github.com/ankhorage/data-sources/issues"
+  },
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ankhorage/data-sources.git"
+  },
+  "keywords": [
+    "ankhorage",
+    "data-sources",
+    "api",
+    "openapi",
+    "graphql",
+    "rest",
+    "typescript"
+  ],
+  "dependencies": {
+    "@ankhorage/contracts": "^1.12.0"
+  },
+  "files": [
+    "dist",
+    "src",
+    "package.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "browser": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist tsconfig.tsbuildinfo && bun x tsc -p tsconfig.build.json",
+    "changeset": "changeset",
+    "changeset:status": "changeset status --since=origin/main",
+    "docs": "paradox",
+    "knip": "ankhorage-knip",
+    "lint": "ankhorage-eslint . --max-warnings=0",
+    "lint:fix": "ankhorage-eslint . --fix --max-warnings=0",
+    "format": "ankhorage-prettier --write .",
+    "format:check": "ankhorage-prettier --check .",
+    "prepack": "bun run build",
+    "test": "bun test src",
+    "typecheck": "bun x tsc --noEmit -p tsconfig.json",
+    "version-packages": "changeset version"
+  },
+  "devDependencies": {
+    "@ankhorage/devtools": "^1.0.6",
+    "@ankhorage/paradox": "^0.1.7",
+    "@changesets/cli": "^2.30.0",
+    "@types/bun": "^1.3.13",
+    "@types/node": "^25.6.0",
+    "typescript": "^5.9.3"
+  },
+  "packageManager": "bun@1.3.13"
+}

package/src/index.test.ts

@@ -0,0 +1,39 @@
+import type { RestDataSourceConfig } from '@ankhorage/contracts/data';
+import { describe, expect, it } from 'bun:test';
+
+import {
+  DATA_SOURCES_PACKAGE_NAME,
+  getDataSourceKind,
+  getDataSourcesPackageInfo,
+  isSupportedDataSourceKind,
+  SUPPORTED_DATA_SOURCE_KINDS,
+} from './index';
+
+describe('data-sources package baseline', () => {
+  it('exports package metadata', () => {
+    const info = getDataSourcesPackageInfo();
+
+    expect(info.packageName).toBe(DATA_SOURCES_PACKAGE_NAME);
+    expect(info.supportedKinds).toEqual(SUPPORTED_DATA_SOURCE_KINDS);
+  });
+
+  it('recognizes supported shared contract data-source kinds', () => {
+    expect(isSupportedDataSourceKind('rest')).toBe(true);
+    expect(isSupportedDataSourceKind('openapi')).toBe(true);
+    expect(isSupportedDataSourceKind('graphql')).toBe(true);
+    expect(isSupportedDataSourceKind('managed-api')).toBe(true);
+    expect(isSupportedDataSourceKind('database')).toBe(true);
+    expect(isSupportedDataSourceKind('studio')).toBe(false);
+  });
+
+  it('consumes data-source contracts from @ankhorage/contracts', () => {
+    const source: RestDataSourceConfig = {
+      id: 'cms',
+      kind: 'rest',
+      baseUrl: 'https://cms.example.com',
+      endpoints: {},
+    };
+
+    expect(getDataSourceKind(source)).toBe('rest');
+  });
+});

package/src/index.ts

@@ -0,0 +1,31 @@
+import type { DataSourceConfig, DataSourceKind } from '@ankhorage/contracts/data';
+
+export const DATA_SOURCES_PACKAGE_NAME = '@ankhorage/data-sources' as const;
+
+export const SUPPORTED_DATA_SOURCE_KINDS = [
+  'database',
+  'graphql',
+  'managed-api',
+  'openapi',
+  'rest',
+] as const satisfies readonly DataSourceKind[];
+
+export interface DataSourcesPackageInfo {
+  readonly packageName: typeof DATA_SOURCES_PACKAGE_NAME;
+  readonly supportedKinds: typeof SUPPORTED_DATA_SOURCE_KINDS;
+}
+
+export function getDataSourcesPackageInfo(): DataSourcesPackageInfo {
+  return {
+    packageName: DATA_SOURCES_PACKAGE_NAME,
+    supportedKinds: SUPPORTED_DATA_SOURCE_KINDS,
+  };
+}
+
+export function isSupportedDataSourceKind(kind: string): kind is DataSourceKind {
+  return SUPPORTED_DATA_SOURCE_KINDS.some((supportedKind) => supportedKind === kind);
+}
+
+export function getDataSourceKind(source: DataSourceConfig): DataSourceKind {
+  return source.kind;
+}