@kurrent/kurrentdb-client 1.0.4 → 1.2.0-alpha.0

package/dist/schemaRegistry/types.d.ts

@@ -0,0 +1,347 @@
+import type { BaseOptions } from "../types";
+/**
+ * Schema data format types supported by the schema registry.
+ */
+export type SchemaDataFormat = "json" | "protobuf" | "avro" | "bytes";
+/**
+ * Schema compatibility modes for version validation.
+ */
+export type CompatibilityMode = "backward" | "forward" | "full" | "backward-all" | "forward-all" | "full-all" | "none";
+/**
+ * Schema details for creating or updating a schema.
+ */
+export interface SchemaDetails {
+    /**
+     * The data format of the schema.
+     */
+    dataFormat: SchemaDataFormat;
+    /**
+     * The compatibility mode for schema versions.
+     */
+    compatibility: CompatibilityMode;
+    /**
+     * Optional description of the schema.
+     */
+    description?: string;
+    /**
+     * Optional tags for the schema.
+     */
+    tags?: Record<string, string>;
+}
+/**
+ * Represents a schema in the registry.
+ */
+export interface Schema {
+    /**
+     * The name of the schema.
+     */
+    schemaName: string;
+    /**
+     * The schema details.
+     */
+    details: SchemaDetails;
+    /**
+     * The latest version number of the schema.
+     */
+    latestSchemaVersion: number;
+    /**
+     * When the schema was created.
+     */
+    createdAt?: Date;
+    /**
+     * When the schema was last updated.
+     */
+    updatedAt?: Date;
+}
+/**
+ * Represents a version of a schema.
+ */
+export interface SchemaVersion {
+    /**
+     * The unique identifier for this schema version.
+     */
+    schemaVersionId: string;
+    /**
+     * The version number.
+     */
+    versionNumber: number;
+    /**
+     * The schema definition bytes.
+     */
+    schemaDefinition: Uint8Array;
+    /**
+     * The data format of the schema.
+     */
+    dataFormat: SchemaDataFormat;
+    /**
+     * When the version was registered.
+     */
+    registeredAt?: Date;
+}
+/**
+ * Represents a registered schema with its latest version information.
+ */
+export interface RegisteredSchema {
+    /**
+     * The name of the schema.
+     */
+    schemaName: string;
+    /**
+     * The unique identifier for the schema version.
+     */
+    schemaVersionId: string;
+    /**
+     * The version number.
+     */
+    versionNumber: number;
+    /**
+     * The schema definition bytes.
+     */
+    schemaDefinition?: Uint8Array;
+    /**
+     * The data format of the schema.
+     */
+    dataFormat: SchemaDataFormat;
+    /**
+     * The compatibility mode for schema versions.
+     */
+    compatibility: CompatibilityMode;
+    /**
+     * Tags associated with the schema.
+     */
+    tags: Record<string, string>;
+    /**
+     * When the version was registered.
+     */
+    registeredAt?: Date;
+}
+/**
+ * Error details for a schema version operation.
+ */
+export interface SchemaVersionError {
+    /**
+     * The version number that had an error.
+     */
+    versionNumber: number;
+    /**
+     * The error details.
+     */
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Schema compatibility error information.
+ */
+export interface SchemaCompatibilityError {
+    /**
+     * The kind of compatibility error.
+     */
+    kind: SchemaCompatibilityErrorKind;
+    /**
+     * Detailed description of the error.
+     */
+    details: string;
+    /**
+     * The property path where the error occurred.
+     */
+    propertyPath?: string;
+    /**
+     * The original type before the change.
+     */
+    originalType?: string;
+    /**
+     * The new type after the change.
+     */
+    newType?: string;
+}
+/**
+ * Types of schema compatibility errors.
+ */
+export type SchemaCompatibilityErrorKind = "unspecified" | "missing-required-property" | "incompatible-type-change" | "optional-to-required" | "new-required-property" | "removed-property" | "array-type-incompatibility" | "data-format-mismatch";
+/**
+ * Options for creating a schema.
+ */
+export interface CreateSchemaOptions extends BaseOptions {
+    /**
+     * Optional initial schema definition. If provided, the schema will be created
+     * with version 1 containing this definition.
+     */
+    schemaDefinition?: string | Uint8Array;
+}
+/**
+ * Result of creating a schema.
+ */
+export interface CreateSchemaResult {
+    /**
+     * The schema version ID (only present if schemaDefinition was provided).
+     */
+    schemaVersionId?: string;
+    /**
+     * The version number (only present if schemaDefinition was provided).
+     */
+    versionNumber?: number;
+}
+/**
+ * Options for updating a schema.
+ */
+export interface UpdateSchemaOptions extends BaseOptions {
+    /**
+     * The data format of the schema (must match existing schema).
+     */
+    dataFormat: SchemaDataFormat;
+    /**
+     * The compatibility mode (must match existing schema).
+     */
+    compatibility: CompatibilityMode;
+    /**
+     * Updated description for the schema.
+     */
+    description?: string;
+    /**
+     * Updated tags for the schema.
+     */
+    tags?: Record<string, string>;
+}
+/**
+ * Options for deleting a schema.
+ */
+export type DeleteSchemaOptions = BaseOptions;
+/**
+ * Options for getting a schema.
+ */
+export type GetSchemaOptions = BaseOptions;
+/**
+ * Options for listing schemas.
+ */
+export interface ListSchemasOptions extends BaseOptions {
+    /**
+     * Filter schemas by name prefix.
+     */
+    schemaNamePrefix?: string;
+    /**
+     * Filter schemas by tags.
+     */
+    schemaTags?: Record<string, string>;
+}
+/**
+ * Options for looking up a schema name.
+ */
+export type LookupSchemaNameOptions = BaseOptions;
+/**
+ * Options for registering a schema version.
+ */
+export type RegisterSchemaVersionOptions = BaseOptions;
+/**
+ * Result of registering a schema version.
+ */
+export interface RegisterSchemaVersionResult {
+    /**
+     * The unique identifier for the registered schema version.
+     */
+    schemaVersionId: string;
+    /**
+     * The version number assigned to the registration.
+     */
+    versionNumber: number;
+}
+/**
+ * Options for deleting schema versions.
+ */
+export type DeleteSchemaVersionsOptions = BaseOptions;
+/**
+ * Result of deleting schema versions.
+ */
+export interface DeleteSchemaVersionsResult {
+    /**
+     * Errors that occurred during deletion, if any.
+     */
+    errors: SchemaVersionError[];
+}
+/**
+ * Options for getting a schema version.
+ */
+export interface GetSchemaVersionOptions extends BaseOptions {
+    /**
+     * The specific version number to retrieve. If not provided, returns the latest version.
+     */
+    versionNumber?: number;
+}
+/**
+ * Options for getting a schema version by ID.
+ */
+export type GetSchemaVersionByIdOptions = BaseOptions;
+/**
+ * Options for listing schema versions.
+ */
+export interface ListSchemaVersionsOptions extends BaseOptions {
+    /**
+     * Whether to include the schema definition in the response.
+     * @defaultValue false
+     */
+    includeDefinition?: boolean;
+}
+/**
+ * Options for listing registered schemas.
+ */
+export interface ListRegisteredSchemasOptions extends BaseOptions {
+    /**
+     * Filter by a specific schema version ID.
+     */
+    schemaVersionId?: string;
+    /**
+     * Filter schemas by name prefix.
+     */
+    schemaNamePrefix?: string;
+    /**
+     * Filter schemas by tags.
+     */
+    schemaTags?: Record<string, string>;
+    /**
+     * Whether to include the schema definition in the response.
+     * @defaultValue false
+     */
+    includeDefinition?: boolean;
+}
+/**
+ * Options for checking schema compatibility.
+ */
+export interface CheckSchemaCompatibilityOptions extends BaseOptions {
+    /**
+     * The schema name to check compatibility against.
+     * Either schemaName or schemaVersionId must be provided.
+     */
+    schemaName?: string;
+    /**
+     * The specific schema version ID to check compatibility against.
+     * Either schemaName or schemaVersionId must be provided.
+     */
+    schemaVersionId?: string;
+    /**
+     * The data format of the schema definition being checked.
+     */
+    dataFormat: SchemaDataFormat;
+}
+/**
+ * Result of checking schema compatibility.
+ */
+export type CheckSchemaCompatibilityResult = {
+    /**
+     * Whether the schema is compatible.
+     */
+    isCompatible: true;
+    /**
+     * The schema version ID that was checked against.
+     */
+    schemaVersionId: string;
+} | {
+    /**
+     * Whether the schema is compatible.
+     */
+    isCompatible: false;
+    /**
+     * The compatibility errors found.
+     */
+    errors: SchemaCompatibilityError[];
+};

package/dist/schemaRegistry/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/schemaRegistry/types.js.map

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

package/dist/schemaRegistry/updateSchema.d.ts

@@ -0,0 +1,11 @@
+import type { UpdateSchemaOptions } from "./types";
+declare module "../Client" {
+    interface Client {
+        /**
+         * Updates schema metadata (description and/or tags).
+         * @param schemaName - The name of the schema to update.
+         * @param options - The update options including description and tags to update.
+         */
+        updateSchema(schemaName: string, options?: UpdateSchemaOptions): Promise<void>;
+    }
+}

package/dist/schemaRegistry/updateSchema.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const field_mask_pb_1 = require("google-protobuf/google/protobuf/field_mask_pb");
+const service_grpc_pb_1 = require("../../generated/kurrentdb/protocols/v2/registry/service_grpc_pb");
+const schemas_pb_1 = require("../../generated/kurrentdb/protocols/v2/registry/schemas_pb");
+const Client_1 = require("../Client");
+const utils_1 = require("../utils");
+const utils_2 = require("./utils");
+Client_1.Client.prototype.updateSchema = async function (schemaName, options) {
+    const { description, tags, dataFormat, compatibility, ...baseOptions } = options;
+    const req = new schemas_pb_1.UpdateSchemaRequest();
+    req.setSchemaName(schemaName);
+    const details = new schemas_pb_1.SchemaDetails();
+    const updatePaths = [];
+    // dataFormat and compatibility are required fields but not updated via field mask
+    details.setDataFormat((0, utils_2.mapSchemaDataFormatToGrpc)(dataFormat));
+    details.setCompatibility((0, utils_2.mapCompatibilityModeToGrpc)(compatibility));
+    if (description !== undefined) {
+        details.setDescription(description);
+        updatePaths.push("details.description");
+    }
+    if (tags !== undefined) {
+        const tagsMap = details.getTagsMap();
+        for (const [key, value] of Object.entries(tags)) {
+            tagsMap.set(key, value);
+        }
+        updatePaths.push("details.tags");
+    }
+    req.setDetails(details);
+    if (updatePaths.length > 0) {
+        const fieldMask = new field_mask_pb_1.FieldMask();
+        fieldMask.setPathsList(updatePaths);
+        req.setUpdateMask(fieldMask);
+    }
+    utils_1.debug.command("updateSchema: %O", {
+        schemaName,
+        description,
+        tags,
+        updatePaths,
+        options: baseOptions,
+    });
+    utils_1.debug.command_grpc("updateSchema: %g", req);
+    return this.execute(service_grpc_pb_1.SchemaRegistryServiceClient, "updateSchema", (client) => new Promise((resolve, reject) => {
+        client.updateSchema(req, ...this.callArguments(baseOptions), (error) => {
+            if (error)
+                return reject((0, utils_1.convertToCommandError)(error));
+            return resolve();
+        });
+    }));
+};
+//# sourceMappingURL=updateSchema.js.map

package/dist/schemaRegistry/updateSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateSchema.js","sourceRoot":"","sources":["../../src/schemaRegistry/updateSchema.ts"],"names":[],"mappings":";;AAAA,iFAA0E;AAE1E,qGAA8G;AAC9G,2FAGoE;AAEpE,sCAAmC;AACnC,oCAAwD;AAGxD,mCAAgF;AAgBhF,eAAM,CAAC,SAAS,CAAC,YAAY,GAAG,KAAK,WAEnC,UAAkB,EAClB,OAA4B;IAE5B,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,GACpE,OAAO,CAAC;IAEV,MAAM,GAAG,GAAG,IAAI,gCAAmB,EAAE,CAAC;IACtC,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAE9B,MAAM,OAAO,GAAG,IAAI,0BAAiB,EAAE,CAAC;IACxC,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,kFAAkF;IAClF,OAAO,CAAC,aAAa,CAAC,IAAA,iCAAyB,EAAC,UAAU,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,gBAAgB,CAAC,IAAA,kCAA0B,EAAC,aAAa,CAAC,CAAC,CAAC;IAEpE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACpC,WAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAExB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,yBAAS,EAAE,CAAC;QAClC,SAAS,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACpC,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED,aAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE;QAChC,UAAU;QACV,WAAW;QACX,IAAI;QACJ,WAAW;QACX,OAAO,EAAE,WAAW;KACrB,CAAC,CAAC;IACH,aAAK,CAAC,YAAY,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAE5C,OAAO,IAAI,CAAC,OAAO,CACjB,6CAA2B,EAC3B,cAAc,EACd,CAAC,MAAM,EAAE,EAAE,CACT,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpC,MAAM,CAAC,YAAY,CACjB,GAAG,EACH,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAClC,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,KAAK;gBAAE,OAAO,MAAM,CAAC,IAAA,6BAAqB,EAAC,KAAK,CAAC,CAAC,CAAC;YACvD,OAAO,OAAO,EAAE,CAAC;QACnB,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;AACJ,CAAC,CAAC"}

package/dist/schemaRegistry/utils/index.d.ts

@@ -0,0 +1 @@
+export * from "./mappers";

package/dist/schemaRegistry/utils/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./mappers"), exports);
+//# sourceMappingURL=index.js.map

package/dist/schemaRegistry/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemaRegistry/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B"}

package/dist/schemaRegistry/utils/mappers.d.ts

@@ -0,0 +1,24 @@
+import { Timestamp } from "google-protobuf/google/protobuf/timestamp_pb";
+import { SchemaDataFormat as GrpcSchemaDataFormat, CompatibilityMode as GrpcCompatibilityMode } from "../../../generated/kurrentdb/protocols/v2/registry/shared_pb";
+import { Schema as GrpcSchema, SchemaDetails as GrpcSchemaDetails, SchemaVersion as GrpcSchemaVersion, RegisteredSchema as GrpcRegisteredSchema, DeleteSchemaVersionsResponse } from "../../../generated/kurrentdb/protocols/v2/registry/schemas_pb";
+import { SchemaCompatibilityError as GrpcSchemaCompatibilityError } from "../../../generated/kurrentdb/protocols/v2/registry/validation_pb";
+import type { SchemaDataFormat, CompatibilityMode, Schema, SchemaDetails, SchemaVersion, RegisteredSchema, SchemaVersionError, SchemaCompatibilityError } from "../types";
+export declare function mapSchemaDataFormatToGrpc(format: SchemaDataFormat): GrpcSchemaDataFormat;
+export declare function mapGrpcSchemaDataFormat(format: GrpcSchemaDataFormat): SchemaDataFormat;
+export declare function mapCompatibilityModeToGrpc(mode: CompatibilityMode): GrpcCompatibilityMode;
+export declare function mapGrpcCompatibilityMode(mode: GrpcCompatibilityMode): CompatibilityMode;
+export declare function mapGrpcTimestamp(timestamp: Timestamp | undefined): Date | undefined;
+export declare function mapGrpcSchemaDetails(details: GrpcSchemaDetails | undefined): SchemaDetails;
+export declare function mapGrpcSchema(grpcSchema: GrpcSchema): Schema;
+export declare function mapGrpcSchemaVersion(grpcVersion: GrpcSchemaVersion): SchemaVersion;
+export declare function mapGrpcRegisteredSchema(grpcSchema: GrpcRegisteredSchema): RegisteredSchema;
+export declare function mapGrpcSchemaVersionError(error: DeleteSchemaVersionsResponse.SchemaVersionError): SchemaVersionError;
+export declare function mapGrpcSchemaCompatibilityError(error: GrpcSchemaCompatibilityError): SchemaCompatibilityError;
+/**
+ * Converts a string or Uint8Array schema definition to Uint8Array.
+ */
+export declare function toSchemaDefinitionBytes(definition: string | Uint8Array): Uint8Array;
+/**
+ * Creates a GrpcSchemaDetails from the input parameters.
+ */
+export declare function createGrpcSchemaDetails(details: SchemaDetails): GrpcSchemaDetails;

package/dist/schemaRegistry/utils/mappers.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapSchemaDataFormatToGrpc = mapSchemaDataFormatToGrpc;
+exports.mapGrpcSchemaDataFormat = mapGrpcSchemaDataFormat;
+exports.mapCompatibilityModeToGrpc = mapCompatibilityModeToGrpc;
+exports.mapGrpcCompatibilityMode = mapGrpcCompatibilityMode;
+exports.mapGrpcTimestamp = mapGrpcTimestamp;
+exports.mapGrpcSchemaDetails = mapGrpcSchemaDetails;
+exports.mapGrpcSchema = mapGrpcSchema;
+exports.mapGrpcSchemaVersion = mapGrpcSchemaVersion;
+exports.mapGrpcRegisteredSchema = mapGrpcRegisteredSchema;
+exports.mapGrpcSchemaVersionError = mapGrpcSchemaVersionError;
+exports.mapGrpcSchemaCompatibilityError = mapGrpcSchemaCompatibilityError;
+exports.toSchemaDefinitionBytes = toSchemaDefinitionBytes;
+exports.createGrpcSchemaDetails = createGrpcSchemaDetails;
+const shared_pb_1 = require("../../../generated/kurrentdb/protocols/v2/registry/shared_pb");
+const schemas_pb_1 = require("../../../generated/kurrentdb/protocols/v2/registry/schemas_pb");
+const validation_pb_1 = require("../../../generated/kurrentdb/protocols/v2/registry/validation_pb");
+// ============================================================================
+// Enum Mappers
+// ============================================================================
+const schemaDataFormatToGrpc = {
+    json: shared_pb_1.SchemaDataFormat.SCHEMA_DATA_FORMAT_JSON,
+    protobuf: shared_pb_1.SchemaDataFormat.SCHEMA_DATA_FORMAT_PROTOBUF,
+    avro: shared_pb_1.SchemaDataFormat.SCHEMA_DATA_FORMAT_AVRO,
+    bytes: shared_pb_1.SchemaDataFormat.SCHEMA_DATA_FORMAT_BYTES,
+};
+const grpcSchemaDataFormatMap = {
+    [shared_pb_1.SchemaDataFormat.SCHEMA_DATA_FORMAT_UNSPECIFIED]: "bytes",
+    [shared_pb_1.SchemaDataFormat.SCHEMA_DATA_FORMAT_JSON]: "json",
+    [shared_pb_1.SchemaDataFormat.SCHEMA_DATA_FORMAT_PROTOBUF]: "protobuf",
+    [shared_pb_1.SchemaDataFormat.SCHEMA_DATA_FORMAT_AVRO]: "avro",
+    [shared_pb_1.SchemaDataFormat.SCHEMA_DATA_FORMAT_BYTES]: "bytes",
+};
+const compatibilityModeToGrpc = {
+    backward: shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_BACKWARD,
+    forward: shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_FORWARD,
+    full: shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_FULL,
+    "backward-all": shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_BACKWARD_ALL,
+    "forward-all": shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_FORWARD_ALL,
+    "full-all": shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_FULL_ALL,
+    none: shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_NONE,
+};
+const grpcCompatibilityModeMap = {
+    [shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_UNSPECIFIED]: "none",
+    [shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_BACKWARD]: "backward",
+    [shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_FORWARD]: "forward",
+    [shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_FULL]: "full",
+    [shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_BACKWARD_ALL]: "backward-all",
+    [shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_FORWARD_ALL]: "forward-all",
+    [shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_FULL_ALL]: "full-all",
+    [shared_pb_1.CompatibilityMode.COMPATIBILITY_MODE_NONE]: "none",
+};
+const grpcSchemaCompatibilityErrorKindMap = {
+    [validation_pb_1.SchemaCompatibilityErrorKind.SCHEMA_COMPATIBILITY_ERROR_KIND_UNSPECIFIED]: "unspecified",
+    [validation_pb_1.SchemaCompatibilityErrorKind.SCHEMA_COMPATIBILITY_ERROR_KIND_MISSING_REQUIRED_PROPERTY]: "missing-required-property",
+    [validation_pb_1.SchemaCompatibilityErrorKind.SCHEMA_COMPATIBILITY_ERROR_KIND_INCOMPATIBLE_TYPE_CHANGE]: "incompatible-type-change",
+    [validation_pb_1.SchemaCompatibilityErrorKind.SCHEMA_COMPATIBILITY_ERROR_KIND_OPTIONAL_TO_REQUIRED]: "optional-to-required",
+    [validation_pb_1.SchemaCompatibilityErrorKind.SCHEMA_COMPATIBILITY_ERROR_KIND_NEW_REQUIRED_PROPERTY]: "new-required-property",
+    [validation_pb_1.SchemaCompatibilityErrorKind.SCHEMA_COMPATIBILITY_ERROR_KIND_REMOVED_PROPERTY]: "removed-property",
+    [validation_pb_1.SchemaCompatibilityErrorKind.SCHEMA_COMPATIBILITY_ERROR_KIND_ARRAY_TYPE_INCOMPATIBILITY]: "array-type-incompatibility",
+    [validation_pb_1.SchemaCompatibilityErrorKind.SCHEMA_COMPATIBILITY_ERROR_KIND_DATA_FORMAT_MISMATCH]: "data-format-mismatch",
+};
+// ============================================================================
+// Export Enum Conversion Functions
+// ============================================================================
+function mapSchemaDataFormatToGrpc(format) {
+    return schemaDataFormatToGrpc[format];
+}
+function mapGrpcSchemaDataFormat(format) {
+    return grpcSchemaDataFormatMap[format];
+}
+function mapCompatibilityModeToGrpc(mode) {
+    return compatibilityModeToGrpc[mode];
+}
+function mapGrpcCompatibilityMode(mode) {
+    return grpcCompatibilityModeMap[mode];
+}
+// ============================================================================
+// Timestamp Mapper
+// ============================================================================
+function mapGrpcTimestamp(timestamp) {
+    if (!timestamp)
+        return undefined;
+    const seconds = timestamp.getSeconds();
+    const nanos = timestamp.getNanos();
+    return new Date(seconds * 1000 + Math.floor(nanos / 1_000_000));
+}
+// ============================================================================
+// Map Utilities
+// ============================================================================
+function mapToRecord(map) {
+    const result = {};
+    if (Array.isArray(map)) {
+        for (const [key, value] of map) {
+            result[key] = value;
+        }
+    }
+    else {
+        map.forEach((value, key) => {
+            result[key] = value;
+        });
+    }
+    return result;
+}
+// ============================================================================
+// Message Mappers
+// ============================================================================
+function mapGrpcSchemaDetails(details) {
+    if (!details) {
+        return {
+            dataFormat: "bytes",
+            compatibility: "none",
+        };
+    }
+    return {
+        dataFormat: mapGrpcSchemaDataFormat(details.getDataFormat()),
+        compatibility: mapGrpcCompatibilityMode(details.getCompatibility()),
+        description: details.getDescription(),
+        tags: mapToRecord(details.getTagsMap().toArray()),
+    };
+}
+function mapGrpcSchema(grpcSchema) {
+    return {
+        schemaName: grpcSchema.getSchemaName(),
+        details: mapGrpcSchemaDetails(grpcSchema.getDetails()),
+        latestSchemaVersion: grpcSchema.getLatestSchemaVersion(),
+        createdAt: mapGrpcTimestamp(grpcSchema.getCreatedAt()),
+        updatedAt: mapGrpcTimestamp(grpcSchema.getUpdatedAt()),
+    };
+}
+function mapGrpcSchemaVersion(grpcVersion) {
+    return {
+        schemaVersionId: grpcVersion.getSchemaVersionId(),
+        versionNumber: grpcVersion.getVersionNumber(),
+        schemaDefinition: grpcVersion.getSchemaDefinition_asU8(),
+        dataFormat: mapGrpcSchemaDataFormat(grpcVersion.getDataFormat()),
+        registeredAt: mapGrpcTimestamp(grpcVersion.getRegisteredAt()),
+    };
+}
+function mapGrpcRegisteredSchema(grpcSchema) {
+    const definition = grpcSchema.getSchemaDefinition_asU8();
+    return {
+        schemaName: grpcSchema.getSchemaName(),
+        schemaVersionId: grpcSchema.getSchemaVersionId(),
+        versionNumber: grpcSchema.getVersionNumber(),
+        schemaDefinition: definition.length > 0 ? definition : undefined,
+        dataFormat: mapGrpcSchemaDataFormat(grpcSchema.getDataFormat()),
+        compatibility: mapGrpcCompatibilityMode(grpcSchema.getCompatibility()),
+        tags: mapToRecord(grpcSchema.getTagsMap().toArray()),
+        registeredAt: mapGrpcTimestamp(grpcSchema.getRegisteredAt()),
+    };
+}
+function mapGrpcSchemaVersionError(error) {
+    return {
+        versionNumber: error.getVersionNumber(),
+    };
+}
+function mapGrpcSchemaCompatibilityError(error) {
+    return {
+        kind: grpcSchemaCompatibilityErrorKindMap[error.getKind()],
+        details: error.getDetails(),
+        propertyPath: error.getPropertyPath() || undefined,
+        originalType: error.getOriginalType() || undefined,
+        newType: error.getNewType() || undefined,
+    };
+}
+// ============================================================================
+// Input Conversion Utilities
+// ============================================================================
+/**
+ * Converts a string or Uint8Array schema definition to Uint8Array.
+ */
+function toSchemaDefinitionBytes(definition) {
+    if (typeof definition === "string") {
+        return new TextEncoder().encode(definition);
+    }
+    return definition;
+}
+/**
+ * Creates a GrpcSchemaDetails from the input parameters.
+ */
+function createGrpcSchemaDetails(details) {
+    const grpcDetails = new schemas_pb_1.SchemaDetails();
+    grpcDetails.setDataFormat(mapSchemaDataFormatToGrpc(details.dataFormat));
+    grpcDetails.setCompatibility(mapCompatibilityModeToGrpc(details.compatibility));
+    if (details.description !== undefined) {
+        grpcDetails.setDescription(details.description);
+    }
+    if (details.tags) {
+        const tagsMap = grpcDetails.getTagsMap();
+        for (const [key, value] of Object.entries(details.tags)) {
+            tagsMap.set(key, value);
+        }
+    }
+    return grpcDetails;
+}
+//# sourceMappingURL=mappers.js.map