@relkit/provider 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rel-kit
+
+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,5 @@
+# @relkit/provider
+
+Portable provider authoring and binding protocol for RELKIT.
+
+See [@relkit/app](https://github.com/rel-kit/relkit) for supported application APIs.

package/dist/binding-normalization.d.ts

@@ -0,0 +1,15 @@
+import type { ProviderProfileSelection } from "./profile-normalization.js";
+import type { NormalizedProviderBinding } from "./protocol-types.js";
+export declare class ProviderFeatureMismatchError extends TypeError {
+    readonly code: "MISSING_PROVIDER_FEATURE";
+    readonly capability: string;
+    readonly profile: string;
+    readonly descriptorId: string;
+    readonly features: readonly string[];
+    constructor(capability: string, profile: string, descriptorId: string, features: readonly string[]);
+}
+export declare function normalizeProviderBinding(selection: ProviderProfileSelection, options: {
+    readonly descriptorId: string;
+    readonly requiredFeatures?: readonly string[];
+}): NormalizedProviderBinding;
+//# sourceMappingURL=binding-normalization.d.ts.map

package/dist/binding-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-normalization.d.ts","sourceRoot":"","sources":["../src/binding-normalization.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,yBAAyB,EAAmB,MAAM,qBAAqB,CAAC;AAEtF,qBAAa,4BAA6B,SAAQ,SAAS;IACzD,QAAQ,CAAC,IAAI,EAAG,0BAA0B,CAAU;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;gBAGnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,SAAS,MAAM,EAAE;CAW9B;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,wBAAwB,EACnC,OAAO,EAAE;IACP,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C,GACA,yBAAyB,CAqB3B"}

package/dist/binding-normalization.js

@@ -0,0 +1,48 @@
+import { deepFreeze, normalizeId, serializeJson } from "@relkit/contracts";
+export class ProviderFeatureMismatchError extends TypeError {
+    code = "MISSING_PROVIDER_FEATURE";
+    capability;
+    profile;
+    descriptorId;
+    features;
+    constructor(capability, profile, descriptorId, features) {
+        super(`${capability} logical descriptor "${descriptorId}" requires missing features from profile "${profile}": ${features.join(", ")}`);
+        this.name = "ProviderFeatureMismatchError";
+        this.capability = capability;
+        this.profile = profile;
+        this.descriptorId = descriptorId;
+        this.features = features;
+    }
+}
+export function normalizeProviderBinding(selection, options) {
+    const adapter = selection.binding.adapter;
+    const supported = new Set(adapter.features.map((feature) => feature.id));
+    const required = [...new Set((options.requiredFeatures ?? []).map(normalizeId))].sort();
+    const missing = required.filter((feature) => !supported.has(feature));
+    if (missing.length > 0)
+        throw new ProviderFeatureMismatchError(selection.capability, selection.profile, normalizeId(options.descriptorId), missing);
+    return frozen({
+        kind: "provider-binding",
+        capability: selection.capability,
+        profile: selection.profile,
+        adapter: projectAdapter(adapter),
+        source: selection.binding.source,
+        ...(selection.binding.local === undefined ? {} : { local: selection.binding.local }),
+        ...(selection.binding.access === undefined ? {} : { access: selection.binding.access }),
+    });
+}
+function projectAdapter(adapter) {
+    return {
+        integrationId: adapter.integration.integrationId,
+        adapterId: adapter.adapterId,
+        protocolVersion: adapter.protocolVersion,
+        behavior: adapter.behavior.value,
+        connectionContract: adapter.connectionContract.fields,
+        connection: adapter.connection,
+        features: adapter.features.map((feature) => feature.id),
+    };
+}
+function frozen(value) {
+    return deepFreeze(JSON.parse(serializeJson(value)));
+}
+//# sourceMappingURL=binding-normalization.js.map

package/dist/binding-normalization.js.map

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

package/dist/binding-resolution.d.ts

@@ -0,0 +1,27 @@
+import { type JsonValue } from "@relkit/contracts";
+import type { ProviderConnectionField, ProviderConnectionValues } from "./protocol-types.js";
+export type ProviderBindingResolutionCode = "CONFLICTING_CONNECTION_VALUE" | "MISSING_CONNECTION_VALUE" | "UNKNOWN_CONNECTION_OUTPUT";
+export declare class ProviderBindingResolutionError extends TypeError {
+    readonly code: ProviderBindingResolutionCode;
+    readonly bindingId: string;
+    readonly field: string;
+    constructor(code: ProviderBindingResolutionCode, bindingId: string, field: string, reason: string);
+}
+export interface ResolveProviderConnectionOptions {
+    readonly profile: string;
+    readonly bindingId?: string;
+    readonly local?: Readonly<Record<string, JsonValue>>;
+    readonly infrastructure?: Readonly<Record<string, JsonValue>>;
+    readonly values?: Readonly<Record<string, JsonValue>>;
+}
+export interface ProviderConnectionDescriptor {
+    readonly capability: Readonly<{
+        readonly id: string;
+    }>;
+    readonly connectionContract: Readonly<{
+        readonly fields: Readonly<Record<string, ProviderConnectionField>>;
+    }>;
+    readonly connection: ProviderConnectionValues;
+}
+export declare function resolveProviderConnection(adapter: ProviderConnectionDescriptor, options: ResolveProviderConnectionOptions): Readonly<Record<string, JsonValue>>;
+//# sourceMappingURL=binding-resolution.d.ts.map

package/dist/binding-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-resolution.d.ts","sourceRoot":"","sources":["../src/binding-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE3F,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE7F,MAAM,MAAM,6BAA6B,GACvC,8BAA8B,GAAG,0BAA0B,GAAG,2BAA2B,CAAC;AAE5F,qBAAa,8BAA+B,SAAQ,SAAS;IAC3D,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAGrB,IAAI,EAAE,6BAA6B,EACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;CAQjB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC;KACpE,CAAC,CAAC;IACH,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;CAC/C;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,4BAA4B,EACrC,OAAO,EAAE,gCAAgC,GACxC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAUrC"}

package/dist/binding-resolution.js

@@ -0,0 +1,65 @@
+import { deepFreeze, normalizeId, serializeJson } from "@relkit/contracts";
+import { isBindingValueRef } from "./binding-values.js";
+export class ProviderBindingResolutionError extends TypeError {
+    code;
+    bindingId;
+    field;
+    constructor(code, bindingId, field, reason) {
+        super(`${bindingId} connection field "${field}" ${reason}`);
+        this.name = "ProviderBindingResolutionError";
+        this.code = code;
+        this.bindingId = bindingId;
+        this.field = field;
+    }
+}
+export function resolveProviderConnection(adapter, options) {
+    const bindingId = options.bindingId ?? `${adapter.capability.id}.${normalizeId(options.profile)}`;
+    assertDeclaredOutputs(bindingId, adapter, "local", options.local);
+    assertDeclaredOutputs(bindingId, adapter, "infrastructure", options.infrastructure);
+    const result = {};
+    for (const [name, field] of Object.entries(adapter.connectionContract.fields)) {
+        const resolved = resolveField(bindingId, name, field, adapter, options);
+        if (resolved !== undefined)
+            result[name] = resolved;
+    }
+    return deepFreeze(JSON.parse(serializeJson(result)));
+}
+function resolveField(bindingId, name, field, adapter, options) {
+    const local = own(options.local, name);
+    const infrastructure = own(options.infrastructure, name);
+    const authored = own(adapter.connection, name);
+    if ((local || infrastructure) && authored && field.authoredValue === "fixed")
+        throw new ProviderBindingResolutionError("CONFLICTING_CONNECTION_VALUE", bindingId, name, `conflicts with ${local ? "local" : "infrastructure"} output`);
+    if (local)
+        return options.local[name];
+    if (infrastructure)
+        return options.infrastructure[name];
+    if (authored) {
+        const value = adapter.connection[name];
+        if (!isBindingValueRef(value))
+            return value;
+        if (own(options.values, value.name))
+            return options.values[value.name];
+        if (own(field, "default"))
+            return field.default;
+        if (field.required)
+            throw new ProviderBindingResolutionError("MISSING_CONNECTION_VALUE", bindingId, name, `requires binding value "${value.name}"`);
+        return undefined;
+    }
+    if (own(field, "default"))
+        return field.default;
+    if (field.required)
+        throw new ProviderBindingResolutionError("MISSING_CONNECTION_VALUE", bindingId, name, "is required");
+    return undefined;
+}
+function assertDeclaredOutputs(bindingId, adapter, source, outputs) {
+    if (outputs === undefined)
+        return;
+    for (const name of Object.keys(outputs))
+        if (!own(adapter.connectionContract.fields, name))
+            throw new ProviderBindingResolutionError("UNKNOWN_CONNECTION_OUTPUT", bindingId, name, `is not declared for ${source} output`);
+}
+function own(value, key) {
+    return value !== undefined && Object.prototype.hasOwnProperty.call(value, key);
+}
+//# sourceMappingURL=binding-resolution.js.map

package/dist/binding-resolution.js.map

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

package/dist/binding-values.d.ts

@@ -0,0 +1,16 @@
+import type { BindingValueRef, BindingValueType } from "./protocol-types.js";
+/**
+ * Creates a named value reference scoped to one provider binding.
+ *
+ * @example
+ * ```ts
+ * import { createBindingValueRef } from "@relkit/provider";
+ * const cacheUrl = createBindingValueRef("CACHE_URL", "secret-string");
+ * ```
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export declare function createBindingValueRef<const Name extends string, Value = unknown, const Type extends BindingValueType = BindingValueType>(name: Name, type: Type): BindingValueRef<Name, Value, Type>;
+/** Returns whether a value is an exact binding-local value reference. */
+export declare function isBindingValueRef(value: unknown): value is BindingValueRef;
+//# sourceMappingURL=binding-values.d.ts.map

package/dist/binding-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-values.d.ts","sourceRoot":"","sources":["../src/binding-values.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAY7E;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,GAAG,OAAO,EACf,KAAK,CAAC,IAAI,SAAS,gBAAgB,GAAG,gBAAgB,EACtD,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAQ5D;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAS1E"}

package/dist/binding-values.js

@@ -0,0 +1,46 @@
+import { deepFreeze, isStableId, normalizeId, serializeJson } from "@relkit/contracts";
+const bindingValueTypes = [
+    "string",
+    "number",
+    "boolean",
+    "port",
+    "url",
+    "json",
+    "secret-string",
+];
+/**
+ * Creates a named value reference scoped to one provider binding.
+ *
+ * @example
+ * ```ts
+ * import { createBindingValueRef } from "@relkit/provider";
+ * const cacheUrl = createBindingValueRef("CACHE_URL", "secret-string");
+ * ```
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export function createBindingValueRef(name, type) {
+    const normalized = normalizeId(name);
+    return frozen({
+        kind: "binding-value-ref",
+        name: normalized,
+        type,
+        sensitive: type === "secret-string",
+    });
+}
+/** Returns whether a value is an exact binding-local value reference. */
+export function isBindingValueRef(value) {
+    return (isRecord(value) &&
+        Reflect.ownKeys(value).length === 4 &&
+        value.kind === "binding-value-ref" &&
+        isStableId(value.name) &&
+        bindingValueTypes.includes(value.type) &&
+        value.sensitive === (value.type === "secret-string"));
+}
+function frozen(value) {
+    return deepFreeze(JSON.parse(serializeJson(value)));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=binding-values.js.map

package/dist/binding-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-values.js","sourceRoot":"","sources":["../src/binding-values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvF,MAAM,iBAAiB,GAAgC;IACrD,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,MAAM;IACN,KAAK;IACL,MAAM;IACN,eAAe;CAChB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAInC,IAAU,EAAE,IAAU;IACtB,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAoB,CAAC;IACxD,OAAO,MAAM,CAAC;QACZ,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,UAAU;QAChB,IAAI;QACJ,SAAS,EAAE,IAAI,KAAK,eAAe;KACpC,CAAuC,CAAC;AAC3C,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QACnC,KAAK,CAAC,IAAI,KAAK,mBAAmB;QAClC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;QACtB,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAwB,CAAC;QAC1D,KAAK,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,CACrD,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAQ,KAAY;IACjC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAU,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./binding-resolution.js";
+export * from "./binding-normalization.js";
+export * from "./binding-values.js";
+export * from "./profile-normalization.js";
+export * from "./protocol-builders.js";
+export * from "./protocol-types.js";
+export * from "./runtime.js";
+export * from "./source-normalization.js";
+//# 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,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from "./binding-resolution.js";
+export * from "./binding-normalization.js";
+export * from "./binding-values.js";
+export * from "./profile-normalization.js";
+export * from "./protocol-builders.js";
+export * from "./protocol-types.js";
+export * from "./runtime.js";
+export * from "./source-normalization.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC"}

package/dist/profile-normalization.d.ts

@@ -0,0 +1,28 @@
+import type { NormalizedProviderSource, ProviderAdapter, ProviderCapability, ProviderSourceInput } from "./protocol-types.js";
+export type ProviderInput<Binding> = Binding | Readonly<Record<string, Binding>>;
+export interface NormalizedProviderProfiles<Adapter extends ProviderAdapter = ProviderAdapter> {
+    readonly kind: "normalized-provider-profiles";
+    readonly capability: string;
+    readonly profiles: Readonly<Record<string, NormalizedProviderSource<Adapter>>>;
+}
+export type ProviderProfileSelectionSource = "descriptor" | "default" | "sole";
+export interface ProviderProfileSelection<Adapter extends ProviderAdapter = ProviderAdapter> {
+    readonly capability: string;
+    readonly profile: string;
+    readonly source: ProviderProfileSelectionSource;
+    readonly binding: NormalizedProviderSource<Adapter>;
+}
+export declare class ProviderProfileSelectionError extends TypeError {
+    readonly code: "AMBIGUOUS_PROVIDER_PROFILE" | "UNKNOWN_PROVIDER_PROFILE";
+    readonly capability: string;
+    readonly descriptorId: string;
+    readonly profiles: readonly string[];
+    constructor(code: ProviderProfileSelectionError["code"], capability: string, descriptorId: string, profiles: readonly string[], reason: string);
+}
+export declare function normalizeProviderProfiles<Adapter extends ProviderAdapter>(capability: ProviderCapability, input: ProviderInput<ProviderSourceInput<Adapter>>): NormalizedProviderProfiles<Adapter>;
+export declare function selectProviderProfile<Adapter extends ProviderAdapter>(normalized: NormalizedProviderProfiles<Adapter>, options: {
+    readonly descriptorId: string;
+    readonly profile?: string;
+    readonly defaultProfile?: string;
+}): ProviderProfileSelection<Adapter>;
+//# sourceMappingURL=profile-normalization.d.ts.map

package/dist/profile-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-normalization.d.ts","sourceRoot":"","sources":["../src/profile-normalization.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,aAAa,CAAC,OAAO,IAAI,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjF,MAAM,WAAW,0BAA0B,CAAC,OAAO,SAAS,eAAe,GAAG,eAAe;IAC3F,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAChF;AAED,MAAM,MAAM,8BAA8B,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/E,MAAM,WAAW,wBAAwB,CAAC,OAAO,SAAS,eAAe,GAAG,eAAe;IACzF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC;CACrD;AAED,qBAAa,6BAA8B,SAAQ,SAAS;IAC1D,QAAQ,CAAC,IAAI,EAAE,4BAA4B,GAAG,0BAA0B,CAAC;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;gBAGnC,IAAI,EAAE,6BAA6B,CAAC,MAAM,CAAC,EAC3C,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,MAAM,EAAE,MAAM;CAWjB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,SAAS,eAAe,EACvE,UAAU,EAAE,kBAAkB,EAC9B,KAAK,EAAE,aAAa,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,GACjD,0BAA0B,CAAC,OAAO,CAAC,CAqBrC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,SAAS,eAAe,EACnE,UAAU,EAAE,0BAA0B,CAAC,OAAO,CAAC,EAC/C,OAAO,EAAE;IACP,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,GACA,wBAAwB,CAAC,OAAO,CAAC,CA6BnC"}

package/dist/profile-normalization.js

@@ -0,0 +1,64 @@
+import { deepFreeze, normalizeId, serializeJson } from "@relkit/contracts";
+import { normalizeProviderSource } from "./source-normalization.js";
+export class ProviderProfileSelectionError extends TypeError {
+    code;
+    capability;
+    descriptorId;
+    profiles;
+    constructor(code, capability, descriptorId, profiles, reason) {
+        super(`${capability} logical descriptor "${descriptorId}" ${reason}; available profiles: ${profiles.join(", ")}`);
+        this.name = "ProviderProfileSelectionError";
+        this.code = code;
+        this.capability = capability;
+        this.descriptorId = descriptorId;
+        this.profiles = profiles;
+    }
+}
+export function normalizeProviderProfiles(capability, input) {
+    const entries = isDirectInput(input) ? [["default", input]] : Object.entries(input);
+    if (entries.length === 0)
+        throw new TypeError(`${capability.id} provider profiles must not be empty`);
+    const profiles = {};
+    for (const [name, source] of entries.sort(([left], [right]) => left.localeCompare(right))) {
+        const profile = normalizeId(name);
+        if (profiles[profile] !== undefined)
+            throw new TypeError(`Duplicate ${capability.id} provider profile "${profile}"`);
+        const normalized = normalizeProviderSource(source);
+        if (normalized.adapter.capability.id !== capability.id)
+            throw new TypeError(`${capability.id} provider profile "${profile}" received ${normalized.adapter.capability.id}.${normalized.adapter.adapterId}`);
+        profiles[profile] = normalized;
+    }
+    return frozen({
+        kind: "normalized-provider-profiles",
+        capability: capability.id,
+        profiles,
+    });
+}
+export function selectProviderProfile(normalized, options) {
+    const profiles = Object.keys(normalized.profiles);
+    const selected = options.profile ?? options.defaultProfile ?? (profiles.length === 1 ? profiles[0] : undefined);
+    const source = options.profile !== undefined
+        ? "descriptor"
+        : options.defaultProfile !== undefined
+            ? "default"
+            : "sole";
+    if (selected === undefined)
+        throw new ProviderProfileSelectionError("AMBIGUOUS_PROVIDER_PROFILE", normalized.capability, normalizeId(options.descriptorId), profiles, "requires an explicit profile");
+    const profile = normalizeId(selected);
+    const binding = normalized.profiles[profile];
+    if (binding === undefined)
+        throw new ProviderProfileSelectionError("UNKNOWN_PROVIDER_PROFILE", normalized.capability, normalizeId(options.descriptorId), profiles, `selected unknown profile "${profile}"`);
+    return frozen({ capability: normalized.capability, profile, source, binding });
+}
+function isDirectInput(value) {
+    if (!isRecord(value) || typeof value.kind !== "string")
+        return false;
+    return ["provider-adapter", "provider-local-source", "provider-infrastructure-source"].includes(value.kind);
+}
+function frozen(value) {
+    return deepFreeze(JSON.parse(serializeJson(value)));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=profile-normalization.js.map

package/dist/profile-normalization.js.map

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

package/dist/protocol-builders.d.ts

@@ -0,0 +1,80 @@
+import { type JsonValue } from "@relkit/contracts";
+import { type IntegrationReference, type ProviderAccess, type ProviderAdapter, type ProviderBehavior, type ProviderCapability, type ProviderConnectionContract, type ProviderConnectionFieldInput, type ProviderConnectionValues, type ProviderFeature, type ProviderLocalRecipeReference } from "./protocol-types.js";
+/**
+ * Defines a stable provider capability identity.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export declare function defineProviderCapability<const Id extends string>(id: Id): ProviderCapability<Id>;
+/**
+ * Defines one feature supported by adapters for a capability.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export declare function defineProviderFeature<const Capability extends ProviderCapability, const Id extends string>(capability: Capability, id: Id): ProviderFeature<Capability["id"], Id>;
+/**
+ * Defines the fields that local, infrastructure, or runtime values may materialize.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export declare function defineConnectionContract(fields: Readonly<Record<string, ProviderConnectionFieldInput>>): ProviderConnectionContract;
+/**
+ * Keeps adapter behavior separate from connection materialization.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export declare function defineProviderBehavior<const Value extends JsonValue>(value: Value): ProviderBehavior<Value>;
+/**
+ * Defines explicit binding or infrastructure access metadata.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export declare function defineProviderAccess<const Value extends JsonValue>(value: Value): ProviderAccess<Value>;
+/**
+ * Defines a static integration identity without accepting an import path.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export declare function defineIntegrationReference<const Id extends string>(integrationId: Id): IntegrationReference<Id>;
+/**
+ * Defines versioned local-recipe provenance for an adapter.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export declare function defineLocalRecipeReference(integration: IntegrationReference, recipeId: string, recipeVersion: number): ProviderLocalRecipeReference;
+/**
+ * Defines a pure adapter descriptor for an integration package.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   defineConnectionContract,
+ *   defineIntegrationReference,
+ *   defineProviderAdapter,
+ *   defineProviderBehavior,
+ *   defineProviderCapability,
+ * } from "@relkit/provider";
+ * const cache = defineProviderCapability("cache");
+ * const redis = defineProviderAdapter({
+ *   integration: defineIntegrationReference("redis"),
+ *   capability: cache,
+ *   adapterId: "redis",
+ *   connectionContract: defineConnectionContract({ url: { sensitive: true } }),
+ *   connection: { url: "redis://localhost:6379" },
+ *   behavior: defineProviderBehavior({}),
+ * });
+ * ```
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export declare function defineProviderAdapter<const Capability extends ProviderCapability, const AdapterId extends string, const Connection extends ProviderConnectionValues, const Behavior extends ProviderBehavior>(options: {
+    readonly integration: IntegrationReference;
+    readonly capability: Capability;
+    readonly adapterId: AdapterId;
+    readonly connectionContract: ProviderConnectionContract;
+    readonly connection: Connection;
+    readonly behavior: Behavior;
+    readonly features?: readonly ProviderFeature<Capability["id"]>[];
+    readonly localRecipe?: ProviderLocalRecipeReference;
+}): ProviderAdapter<Capability, AdapterId, Connection, Behavior>;
+//# sourceMappingURL=protocol-builders.d.ts.map

package/dist/protocol-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-builders.d.ts","sourceRoot":"","sources":["../src/protocol-builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAE/B,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,4BAA4B,EAClC,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAEhG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,CAAC,UAAU,SAAS,kBAAkB,EAC3C,KAAK,CAAC,EAAE,SAAS,MAAM,EACvB,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAMvE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC,GAC7D,0BAA0B,CAkB5B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,KAAK,SAAS,SAAS,EAClE,KAAK,EAAE,KAAK,GACX,gBAAgB,CAAC,KAAK,CAAC,CAEzB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,KAAK,SAAS,SAAS,EAChE,KAAK,EAAE,KAAK,GACX,cAAc,CAAC,KAAK,CAAC,CAEvB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAChE,aAAa,EAAE,EAAE,GAChB,oBAAoB,CAAC,EAAE,CAAC,CAK1B;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,oBAAoB,EACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,4BAA4B,CAQ9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,CAAC,UAAU,SAAS,kBAAkB,EAC3C,KAAK,CAAC,SAAS,SAAS,MAAM,EAC9B,KAAK,CAAC,UAAU,SAAS,wBAAwB,EACjD,KAAK,CAAC,QAAQ,SAAS,gBAAgB,EACvC,OAAO,EAAE;IACT,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,4BAA4B,CAAC;CACrD,GAAG,eAAe,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAuB/D"}

package/dist/protocol-builders.js

@@ -0,0 +1,141 @@
+import { deepFreeze, normalizeId, serializeJson } from "@relkit/contracts";
+import { PROVIDER_PROTOCOL_VERSION, } from "./protocol-types.js";
+/**
+ * Defines a stable provider capability identity.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export function defineProviderCapability(id) {
+    return frozen({ kind: "provider-capability", id: stable(id) });
+}
+/**
+ * Defines one feature supported by adapters for a capability.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export function defineProviderFeature(capability, id) {
+    return frozen({
+        kind: "provider-feature",
+        capability: capability.id,
+        id: stable(id),
+    });
+}
+/**
+ * Defines the fields that local, infrastructure, or runtime values may materialize.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export function defineConnectionContract(fields) {
+    const normalized = {};
+    for (const [name, field] of Object.entries(fields).sort(([left], [right]) => left.localeCompare(right))) {
+        const key = stable(name);
+        if (normalized[key] !== undefined)
+            throw new TypeError(`Duplicate connection field "${key}"`);
+        normalized[key] = {
+            required: field.required ?? true,
+            sensitive: field.sensitive ?? false,
+            authoredValue: field.authoredValue ?? "fixed",
+            ...(field.default === undefined ? {} : { default: field.default }),
+        };
+    }
+    return frozen({
+        kind: "provider-connection-contract",
+        fields: normalized,
+    });
+}
+/**
+ * Keeps adapter behavior separate from connection materialization.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export function defineProviderBehavior(value) {
+    return frozen({ kind: "provider-behavior", value });
+}
+/**
+ * Defines explicit binding or infrastructure access metadata.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export function defineProviderAccess(value) {
+    return frozen({ kind: "provider-access", value });
+}
+/**
+ * Defines a static integration identity without accepting an import path.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export function defineIntegrationReference(integrationId) {
+    return frozen({
+        kind: "integration-reference",
+        integrationId: stable(integrationId),
+    });
+}
+/**
+ * Defines versioned local-recipe provenance for an adapter.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export function defineLocalRecipeReference(integration, recipeId, recipeVersion) {
+    if (!Number.isSafeInteger(recipeVersion) || recipeVersion < 1)
+        throw new TypeError("Local recipe version must be a positive integer");
+    return frozen({
+        integrationId: integration.integrationId,
+        recipeId: stable(recipeId),
+        recipeVersion,
+    });
+}
+/**
+ * Defines a pure adapter descriptor for an integration package.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   defineConnectionContract,
+ *   defineIntegrationReference,
+ *   defineProviderAdapter,
+ *   defineProviderBehavior,
+ *   defineProviderCapability,
+ * } from "@relkit/provider";
+ * const cache = defineProviderCapability("cache");
+ * const redis = defineProviderAdapter({
+ *   integration: defineIntegrationReference("redis"),
+ *   capability: cache,
+ *   adapterId: "redis",
+ *   connectionContract: defineConnectionContract({ url: { sensitive: true } }),
+ *   connection: { url: "redis://localhost:6379" },
+ *   behavior: defineProviderBehavior({}),
+ * });
+ * ```
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export function defineProviderAdapter(options) {
+    const fields = new Set(Object.keys(options.connectionContract.fields));
+    for (const name of Object.keys(options.connection))
+        if (!fields.has(name))
+            throw new TypeError(`Unknown connection field "${name}"`);
+    const features = [...(options.features ?? [])].sort((left, right) => left.id.localeCompare(right.id));
+    if (features.some((feature) => feature.capability !== options.capability.id))
+        throw new TypeError(`Provider feature capability must be "${options.capability.id}"`);
+    if (new Set(features.map((feature) => feature.id)).size !== features.length)
+        throw new TypeError("Duplicate provider feature");
+    return frozen({
+        kind: "provider-adapter",
+        protocolVersion: PROVIDER_PROTOCOL_VERSION,
+        integration: options.integration,
+        capability: options.capability,
+        adapterId: stable(options.adapterId),
+        connectionContract: options.connectionContract,
+        connection: options.connection,
+        behavior: options.behavior,
+        features,
+        ...(options.localRecipe === undefined ? {} : { localRecipe: options.localRecipe }),
+    });
+}
+function stable(value) {
+    return normalizeId(value);
+}
+function frozen(value) {
+    return deepFreeze(JSON.parse(serializeJson(value)));
+}
+//# sourceMappingURL=protocol-builders.js.map

package/dist/protocol-builders.js.map

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

package/dist/protocol-types.d.ts

@@ -0,0 +1,121 @@
+import type { JsonValue } from "@relkit/contracts";
+declare const providerProtocolType: unique symbol;
+type ProviderProtocolType<Name extends string> = {
+    readonly [providerProtocolType]: Name;
+};
+export declare const PROVIDER_PROTOCOL_VERSION: 1;
+export type ProviderProtocolVersion = typeof PROVIDER_PROTOCOL_VERSION;
+export type BindingValueType = "string" | "number" | "boolean" | "port" | "url" | "json" | "secret-string";
+export type BindingValueRef<Name extends string = string, Value = unknown, Type extends BindingValueType = BindingValueType> = Readonly<{
+    kind: "binding-value-ref";
+    name: Name;
+    type: Type;
+    sensitive: Type extends "secret-string" ? true : false;
+    __value?: Value;
+}> & ProviderProtocolType<"binding-value-ref">;
+export type ProviderCapability<Id extends string = string> = Readonly<{
+    kind: "provider-capability";
+    id: Id;
+}> & ProviderProtocolType<"capability">;
+export type ProviderFeature<Capability extends string = string, Id extends string = string> = Readonly<{
+    kind: "provider-feature";
+    capability: Capability;
+    id: Id;
+}> & ProviderProtocolType<"feature">;
+export type ProviderConnectionValueMode = "fixed" | "fallback";
+export interface ProviderConnectionFieldInput {
+    readonly required?: boolean;
+    readonly sensitive?: boolean;
+    readonly authoredValue?: ProviderConnectionValueMode;
+    readonly default?: JsonValue;
+}
+export interface ProviderConnectionField {
+    readonly required: boolean;
+    readonly sensitive: boolean;
+    readonly authoredValue: ProviderConnectionValueMode;
+    readonly default?: JsonValue;
+}
+export type ProviderConnectionFields = Readonly<Record<string, ProviderConnectionField>>;
+export type ProviderConnectionContract<Fields extends ProviderConnectionFields = ProviderConnectionFields> = Readonly<{
+    kind: "provider-connection-contract";
+    fields: Fields;
+}> & ProviderProtocolType<"connection-contract">;
+export type ProviderBehavior<Value extends JsonValue = JsonValue> = Readonly<{
+    kind: "provider-behavior";
+    value: Value;
+}> & ProviderProtocolType<"behavior">;
+export type ProviderAccess<Value extends JsonValue = JsonValue> = Readonly<{
+    kind: "provider-access";
+    value: Value;
+}> & ProviderProtocolType<"access">;
+export type IntegrationReference<Id extends string = string> = Readonly<{
+    kind: "integration-reference";
+    integrationId: Id;
+}> & ProviderProtocolType<"integration-reference">;
+export type ProviderConnectionValue = JsonValue | BindingValueRef;
+export type ProviderConnectionValues = Readonly<Record<string, ProviderConnectionValue>>;
+export type ProviderAdapter<Capability extends ProviderCapability = ProviderCapability, AdapterId extends string = string, Connection extends ProviderConnectionValues = ProviderConnectionValues, Behavior extends ProviderBehavior = ProviderBehavior> = Readonly<{
+    kind: "provider-adapter";
+    protocolVersion: ProviderProtocolVersion;
+    integration: IntegrationReference;
+    capability: Capability;
+    adapterId: AdapterId;
+    connectionContract: ProviderConnectionContract;
+    connection: Connection;
+    behavior: Behavior;
+    features: readonly ProviderFeature<Capability["id"]>[];
+    localRecipe?: ProviderLocalRecipeReference;
+}> & ProviderProtocolType<"adapter">;
+export type LocalProviderSource<Adapter extends ProviderAdapter = ProviderAdapter> = Readonly<{
+    kind: "provider-local-source";
+    adapter: Adapter;
+}> & ProviderProtocolType<"local-source">;
+export type InfrastructureProviderSource<Adapter extends ProviderAdapter = ProviderAdapter> = Readonly<{
+    kind: "provider-infrastructure-source";
+    adapter: Adapter;
+    integration: IntegrationReference;
+    options: JsonValue;
+    access?: ProviderAccess;
+}> & ProviderProtocolType<"infrastructure-source">;
+export type ProviderSourceInput<Adapter extends ProviderAdapter = ProviderAdapter> = Adapter | LocalProviderSource<Adapter> | InfrastructureProviderSource<Adapter>;
+export type ProviderBindingSource = Readonly<{
+    kind: "connected";
+}> | Readonly<{
+    kind: "local-only";
+}> | Readonly<{
+    kind: "infrastructure";
+    integrationId: string;
+    options: JsonValue;
+}>;
+export interface ProviderLocalRecipeReference {
+    readonly integrationId: string;
+    readonly recipeId: string;
+    readonly recipeVersion: number;
+}
+export type NormalizedProviderSource<Adapter extends ProviderAdapter = ProviderAdapter> = Readonly<{
+    kind: "normalized-provider-source";
+    adapter: Adapter;
+    source: ProviderBindingSource;
+    local?: ProviderLocalRecipeReference;
+    access?: JsonValue;
+}> & ProviderProtocolType<"normalized-source">;
+export interface NormalizedProviderAdapter {
+    readonly integrationId: string;
+    readonly adapterId: string;
+    readonly protocolVersion: ProviderProtocolVersion;
+    readonly behavior: JsonValue;
+    readonly connectionContract: ProviderConnectionFields;
+    readonly connection: ProviderConnectionValues;
+    readonly features: readonly string[];
+}
+export type NormalizedProviderBinding = Readonly<{
+    kind: "provider-binding";
+    capability: string;
+    profile: string;
+    adapter: NormalizedProviderAdapter;
+    source: ProviderBindingSource;
+    local?: ProviderLocalRecipeReference;
+    access?: JsonValue;
+}> & ProviderProtocolType<"normalized-binding">;
+export {};
+//# sourceMappingURL=protocol-types.d.ts.map

package/dist/protocol-types.d.ts.map

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

package/dist/protocol-types.js

@@ -0,0 +1,2 @@
+export const PROVIDER_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=protocol-types.js.map

package/dist/protocol-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-types.js","sourceRoot":"","sources":["../src/protocol-types.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAU,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,26 @@
+import type { JsonValue, MaybePromise, RuntimeIntegrationRegistrationMetadata } from "@relkit/contracts";
+export interface RuntimeProviderContext {
+    readonly generationId: string;
+    readonly bindingId: string;
+    readonly capability: string;
+    readonly profile: string;
+    readonly behavior: JsonValue;
+    readonly connection: Readonly<Record<string, JsonValue>>;
+    readonly signal?: AbortSignal;
+}
+export interface RuntimeProviderGeneration {
+    readonly value: unknown;
+    readonly ready?: () => MaybePromise<void>;
+    readonly readiness?: () => MaybePromise<void>;
+    readonly release?: () => MaybePromise<void>;
+    readonly dispose?: () => MaybePromise<void>;
+}
+export interface RuntimeProviderRegistration extends RuntimeIntegrationRegistrationMetadata {
+    readonly create: (context: RuntimeProviderContext) => MaybePromise<RuntimeProviderGeneration>;
+}
+export interface RuntimeProviderIntegration<IntegrationId extends string = string> {
+    readonly kind: "runtime-integration";
+    readonly integrationId: IntegrationId;
+    readonly registrations: readonly RuntimeProviderRegistration[];
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,sCAAsC,EACvC,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,2BAA4B,SAAQ,sCAAsC;IACzF,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,YAAY,CAAC,yBAAyB,CAAC,CAAC;CAC/F;AAED,MAAM,WAAW,0BAA0B,CAAC,aAAa,SAAS,MAAM,GAAG,MAAM;IAC/E,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAChE"}

package/dist/runtime.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":""}

package/dist/source-normalization.d.ts

@@ -0,0 +1,16 @@
+import { type JsonValue } from "@relkit/contracts";
+import type { InfrastructureProviderSource, IntegrationReference, LocalProviderSource, NormalizedProviderSource, ProviderAccess, ProviderAdapter, ProviderSourceInput } from "./protocol-types.js";
+/**
+ * Adds an adapter's declared local recipe without starting it.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export declare function defineLocalProviderSource<const Adapter extends ProviderAdapter>(adapter: Adapter): LocalProviderSource<Adapter>;
+/**
+ * Adds an infrastructure release source and explicit access metadata.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export declare function defineInfrastructureProviderSource<const Adapter extends ProviderAdapter>(adapter: Adapter, integration: IntegrationReference, options: JsonValue, access?: ProviderAccess): InfrastructureProviderSource<Adapter>;
+export declare function normalizeProviderSource<const Adapter extends ProviderAdapter>(input: ProviderSourceInput<Adapter>): NormalizedProviderSource<Adapter>;
+//# sourceMappingURL=source-normalization.d.ts.map

package/dist/source-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-normalization.d.ts","sourceRoot":"","sources":["../src/source-normalization.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,eAAe,EAEf,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,OAAO,SAAS,eAAe,EAC7E,OAAO,EAAE,OAAO,GACf,mBAAmB,CAAC,OAAO,CAAC,CAK9B;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,KAAK,CAAC,OAAO,SAAS,eAAe,EACtF,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,oBAAoB,EACjC,OAAO,EAAE,SAAS,EAClB,MAAM,CAAC,EAAE,cAAc,GACtB,4BAA4B,CAAC,OAAO,CAAC,CAWvC;AAED,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,OAAO,SAAS,eAAe,EAC3E,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAClC,wBAAwB,CAAC,OAAO,CAAC,CA2BnC"}

package/dist/source-normalization.js

@@ -0,0 +1,99 @@
+import { deepFreeze, serializeJson } from "@relkit/contracts";
+/**
+ * Adds an adapter's declared local recipe without starting it.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export function defineLocalProviderSource(adapter) {
+    assertAdapter(adapter);
+    if (adapter.localRecipe === undefined)
+        throw new TypeError(`${label(adapter)} does not declare a local recipe`);
+    return frozen({ kind: "provider-local-source", adapter });
+}
+/**
+ * Adds an infrastructure release source and explicit access metadata.
+ * @category Provider protocol
+ * @since 0.2.0
+ */
+export function defineInfrastructureProviderSource(adapter, integration, options, access) {
+    assertAdapter(adapter);
+    if (adapter.localRecipe === undefined)
+        throw new TypeError(`${label(adapter)} does not declare a default local recipe`);
+    return frozen({
+        kind: "provider-infrastructure-source",
+        adapter,
+        integration,
+        options,
+        ...(access === undefined ? {} : { access }),
+    });
+}
+export function normalizeProviderSource(input) {
+    if (isRecord(input) && input.kind === "provider-adapter") {
+        assertAdapter(input);
+        assertConnected(input);
+        return normalized(input, { kind: "connected" });
+    }
+    if (isRecord(input) && isRecord(input.adapter))
+        assertAdapter(input.adapter);
+    if (!isRecord(input) || !isAdapter(input.adapter))
+        throw new TypeError("Provider source wrappers cannot be nested");
+    if (input.kind === "provider-local-source") {
+        const source = isConfigured(input.adapter)
+            ? { kind: "connected" }
+            : { kind: "local-only" };
+        return normalized(input.adapter, source, input.adapter.localRecipe);
+    }
+    if (input.kind === "provider-infrastructure-source")
+        return normalized(input.adapter, {
+            kind: "infrastructure",
+            integrationId: input.integration.integrationId,
+            options: input.options,
+        }, input.adapter.localRecipe, input.access?.value);
+    throw new TypeError("Invalid provider source descriptor");
+}
+function normalized(adapter, source, local, access) {
+    return frozen({
+        kind: "normalized-provider-source",
+        adapter,
+        source,
+        ...(local === undefined ? {} : { local }),
+        ...(access === undefined ? {} : { access }),
+    });
+}
+function assertConnected(adapter) {
+    const missing = Object.entries(adapter.connectionContract.fields)
+        .filter(([name, field]) => field.required &&
+        !Object.prototype.hasOwnProperty.call(adapter.connection, name) &&
+        !Object.prototype.hasOwnProperty.call(field, "default"))
+        .map(([name]) => name);
+    if (missing.length > 0)
+        throw new TypeError(`${label(adapter)} is missing connection fields: ${missing.join(", ")}`);
+}
+function isConfigured(adapter) {
+    try {
+        assertConnected(adapter);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function assertAdapter(value) {
+    if (isRecord(value) && value.kind === "provider-adapter" && value.protocolVersion !== 1)
+        throw new TypeError(`Provider protocol version ${String(value.protocolVersion)} is unsupported; rewrite the app with current integration constructors.`);
+    if (!isAdapter(value))
+        throw new TypeError("Provider source wrappers cannot be nested");
+}
+function isAdapter(value) {
+    return isRecord(value) && value.kind === "provider-adapter" && value.protocolVersion === 1;
+}
+function label(adapter) {
+    return `${adapter.capability.id}.${adapter.adapterId}`;
+}
+function frozen(value) {
+    return deepFreeze(JSON.parse(serializeJson(value)));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=source-normalization.js.map

package/dist/source-normalization.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@relkit/provider",
+  "version": "0.3.0",
+  "description": "Portable provider authoring and binding protocol for RELKIT.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rel-kit/relkit.git",
+    "directory": "packages/provider"
+  },
+  "homepage": "https://github.com/rel-kit/relkit#readme",
+  "bugs": {
+    "url": "https://github.com/rel-kit/relkit/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.3.10"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@relkit/contracts": "0.3.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "check": "tsc -b --pretty false",
+    "typecheck": "tsc -b --pretty false"
+  }
+}