@daihum/ai-model-contracts 0.1.0 → 0.1.1

package/dist/embedding-compat.cjs

@@ -0,0 +1,55 @@
+
+//#region src/internal/normalize.ts
+function normalizeId(value) {
+	if (typeof value !== "string") return void 0;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : void 0;
+}
+function normalizeRequiredId(value, fieldName) {
+	const normalized = normalizeId(value);
+	if (!normalized) throw new Error(`Invalid ${fieldName}: expected a non-empty string.`);
+	return normalized;
+}
+function normalizePositiveInteger(value) {
+	if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
+	const normalized = Math.trunc(value);
+	return normalized > 0 ? normalized : void 0;
+}
+function normalizeVersionIdentifier(value) {
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) return void 0;
+		const normalized = Math.trunc(value);
+		return normalized >= 0 ? normalized : void 0;
+	}
+	return normalizeId(value);
+}
+function stableObject(value) {
+	return Object.fromEntries(Object.entries(value).filter(([, entryValue]) => entryValue !== void 0).sort(([left], [right]) => left.localeCompare(right)));
+}
+
+//#endregion
+//#region src/embedding-compat.ts
+function buildDaihumAiCompatibilityFingerprint(input) {
+	const basis = stableObject({
+		providerId: normalizeRequiredId(input.providerId, "providerId"),
+		modelId: normalizeId(input.modelId),
+		routeId: normalizeId(input.routeId),
+		dimensions: normalizePositiveInteger(input.dimensions),
+		normalization: normalizeId(input.normalization),
+		distanceMetric: normalizeId(input.distanceMetric),
+		chunkerId: normalizeId(input.chunkerId),
+		chunkStrategyId: normalizeId(input.chunkStrategyId),
+		chunkStrategyVersion: normalizeVersionIdentifier(input.chunkStrategyVersion),
+		chunkStrategyConfigHash: normalizeId(input.chunkStrategyConfigHash),
+		extra: input.extra ? stableObject(input.extra) : void 0
+	});
+	return {
+		algorithm: "daihum-ai.compatibility.v1",
+		value: `daihum-ai.compatibility.v1:${JSON.stringify(basis)}`,
+		basis
+	};
+}
+
+//#endregion
+exports.buildDaihumAiCompatibilityFingerprint = buildDaihumAiCompatibilityFingerprint;
+//# sourceMappingURL=embedding-compat.cjs.map

package/dist/embedding-compat.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-compat.cjs","names":[],"sources":["../src/internal/normalize.ts","../src/embedding-compat.ts"],"sourcesContent":["// Vendored from the former @daihum/ai-core/internal/normalize so this package\n// stays a zero-dependency leaf (see embedding-compat.ts).\n\nexport function normalizeId(value: string | undefined): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\nexport function normalizeRequiredId(value: string, fieldName: string): string {\n  const normalized = normalizeId(value);\n  if (!normalized) {\n    throw new Error(`Invalid ${fieldName}: expected a non-empty string.`);\n  }\n  return normalized;\n}\n\nexport function normalizePositiveInteger(value: number | undefined): number | undefined {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return undefined;\n  const normalized = Math.trunc(value);\n  return normalized > 0 ? normalized : undefined;\n}\n\nexport function normalizeVersionIdentifier(\n  value: number | string | undefined,\n): number | string | undefined {\n  if (typeof value === \"number\") {\n    if (!Number.isFinite(value)) return undefined;\n    const normalized = Math.trunc(value);\n    return normalized >= 0 ? normalized : undefined;\n  }\n  return normalizeId(value);\n}\n\nexport function stableObject<T extends Readonly<Record<string, unknown>>>(value: T): T {\n  return Object.fromEntries(\n    Object.entries(value)\n      .filter(([, entryValue]) => entryValue !== undefined)\n      .sort(([left], [right]) => left.localeCompare(right)),\n  ) as T;\n}\n","import {\n  normalizeId,\n  normalizePositiveInteger,\n  normalizeRequiredId,\n  normalizeVersionIdentifier,\n  stableObject,\n} from \"./internal/normalize.js\";\n\nexport interface DaihumAiCompatibilityFingerprintInput {\n  readonly providerId: string;\n  readonly modelId?: string;\n  readonly routeId?: string;\n  readonly dimensions?: number;\n  readonly normalization?: string;\n  readonly distanceMetric?: string;\n  readonly chunkerId?: string;\n  readonly chunkStrategyId?: string;\n  readonly chunkStrategyVersion?: number | string;\n  readonly chunkStrategyConfigHash?: string;\n  readonly extra?: Readonly<Record<string, unknown>>;\n}\n\nexport interface DaihumAiCompatibilityFingerprint {\n  readonly algorithm: \"daihum-ai.compatibility.v1\";\n  readonly value: string;\n  readonly basis: DaihumAiCompatibilityFingerprintInput;\n}\n\nexport function buildDaihumAiCompatibilityFingerprint(\n  input: DaihumAiCompatibilityFingerprintInput,\n): DaihumAiCompatibilityFingerprint {\n  const basis = stableObject({\n    providerId: normalizeRequiredId(input.providerId, \"providerId\"),\n    modelId: normalizeId(input.modelId),\n    routeId: normalizeId(input.routeId),\n    dimensions: normalizePositiveInteger(input.dimensions),\n    normalization: normalizeId(input.normalization),\n    distanceMetric: normalizeId(input.distanceMetric),\n    chunkerId: normalizeId(input.chunkerId),\n    chunkStrategyId: normalizeId(input.chunkStrategyId),\n    chunkStrategyVersion: normalizeVersionIdentifier(input.chunkStrategyVersion),\n    chunkStrategyConfigHash: normalizeId(input.chunkStrategyConfigHash),\n    extra: input.extra ? stableObject(input.extra) : undefined,\n  });\n\n  return {\n    algorithm: \"daihum-ai.compatibility.v1\",\n    value: `daihum-ai.compatibility.v1:${JSON.stringify(basis)}`,\n    basis,\n  };\n}\n"],"mappings":";;AAGA,SAAgB,YAAY,OAA+C;AACzE,KAAI,OAAO,UAAU,SAAU,QAAO;CACtC,MAAM,UAAU,MAAM,MAAM;AAC5B,QAAO,QAAQ,SAAS,IAAI,UAAU;;AAGxC,SAAgB,oBAAoB,OAAe,WAA2B;CAC5E,MAAM,aAAa,YAAY,MAAM;AACrC,KAAI,CAAC,WACH,OAAM,IAAI,MAAM,WAAW,UAAU,gCAAgC;AAEvE,QAAO;;AAGT,SAAgB,yBAAyB,OAA+C;AACtF,KAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,MAAM,CAAE,QAAO;CACjE,MAAM,aAAa,KAAK,MAAM,MAAM;AACpC,QAAO,aAAa,IAAI,aAAa;;AAGvC,SAAgB,2BACd,OAC6B;AAC7B,KAAI,OAAO,UAAU,UAAU;AAC7B,MAAI,CAAC,OAAO,SAAS,MAAM,CAAE,QAAO;EACpC,MAAM,aAAa,KAAK,MAAM,MAAM;AACpC,SAAO,cAAc,IAAI,aAAa;;AAExC,QAAO,YAAY,MAAM;;AAG3B,SAAgB,aAA0D,OAAa;AACrF,QAAO,OAAO,YACZ,OAAO,QAAQ,MAAM,CAClB,QAAQ,GAAG,gBAAgB,eAAe,OAAU,CACpD,MAAM,CAAC,OAAO,CAAC,WAAW,KAAK,cAAc,MAAM,CAAC,CACxD;;;;;ACXH,SAAgB,sCACd,OACkC;CAClC,MAAM,QAAQ,aAAa;EACzB,YAAY,oBAAoB,MAAM,YAAY,aAAa;EAC/D,SAAS,YAAY,MAAM,QAAQ;EACnC,SAAS,YAAY,MAAM,QAAQ;EACnC,YAAY,yBAAyB,MAAM,WAAW;EACtD,eAAe,YAAY,MAAM,cAAc;EAC/C,gBAAgB,YAAY,MAAM,eAAe;EACjD,WAAW,YAAY,MAAM,UAAU;EACvC,iBAAiB,YAAY,MAAM,gBAAgB;EACnD,sBAAsB,2BAA2B,MAAM,qBAAqB;EAC5E,yBAAyB,YAAY,MAAM,wBAAwB;EACnE,OAAO,MAAM,QAAQ,aAAa,MAAM,MAAM,GAAG;EAClD,CAAC;AAEF,QAAO;EACL,WAAW;EACX,OAAO,8BAA8B,KAAK,UAAU,MAAM;EAC1D;EACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daihum/ai-model-contracts",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "DAIHUM AI pure, serializable model-operation payload contracts: chat, embedding, candidate-rank, tools, usage, embedding-compat. Zero dependencies. Carries NO routing (routePlan), provider selection, secrets, catalog/pricing, runtime, RAG, or product authority. The stable vocabulary leaf.",
   "type": "module",
   "license": "MIT",
@@ -32,7 +32,8 @@
     },
     "./embedding-compat": {
       "types": "./dist/embedding-compat.d.ts",
-      "import": "./dist/embedding-compat.js"
+      "import": "./dist/embedding-compat.js",
+      "require": "./dist/embedding-compat.cjs"
     },
     "./package.json": "./package.json"
   },
@@ -46,9 +47,14 @@
     "typescript": "~5.6.2"
   },
   "sideEffects": false,
+  "publishConfig": {
+    "access": "restricted"
+  },
   "scripts": {
     "build": "tsdown",
     "clean": "rm -rf dist",
+    "test": "node scripts/artifact-conformance.mjs",
+    "test:artifact": "node scripts/artifact-conformance.mjs",
     "typecheck": "tsc --noEmit"
   }
 }