@judo/actions 0.1.0

package/dist/api/judo-rest-api.d.ts

@@ -0,0 +1,262 @@
+import { ClassType, RelationType } from '@judo/model-api';
+import { Application } from '../types';
+import { TransferData, TransferDeserializer, TransferSerializer, TransferStored, JudoRestResponse, QueryCustomizer } from './types';
+/**
+ * Configuration for JUDO REST API client.
+ */
+export interface JudoRestApiConfig {
+    /** Base URL for the API (e.g., http://localhost:8080) */
+    baseUrl: string;
+    /** The application context containing model name and actor info */
+    application: Application;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Default headers to include in all requests */
+    defaultHeaders?: Record<string, string>;
+    /** Optional custom fetch implementation */
+    fetch?: typeof fetch;
+    /** Optional request interceptor */
+    onRequest?: (request: RequestInit) => RequestInit | Promise<RequestInit>;
+    /** Optional response interceptor */
+    onResponse?: (response: Response) => Response | Promise<Response>;
+    /** Optional error handler */
+    onError?: (error: Error) => void;
+    /** Optional transfer serializer for transforming transfers before sending */
+    transferSerializer?: TransferSerializer;
+    /** Optional transfer deserializer for transforming responses */
+    transferDeserializer?: TransferDeserializer;
+}
+/**
+ * Operation metadata for invoking operations.
+ */
+export interface OperationInfo {
+    /** Operation name */
+    name: string;
+    /** Whether the operation is static */
+    isStatic?: boolean;
+    /** Whether the operation is mapped */
+    isMapped?: boolean;
+    /** Whether the operation has input */
+    hasInput?: boolean;
+    /** Input class type (for templates) */
+    inputType?: ClassType;
+}
+/**
+ * JUDO REST API client.
+ * Implements all REST operations according to the specification.
+ */
+export declare class JudoRestApi {
+    private readonly config;
+    private readonly fetchImpl;
+    private _defaultHeaders;
+    constructor(config: JudoRestApiConfig);
+    /**
+     * Update the default headers applied to every request.
+     * Use this to set or remove the Authorization header when the auth token changes.
+     */
+    setDefaultHeaders(headers: Record<string, string>): void;
+    /**
+     * Gets the full URL for a path.
+     */
+    private getUrl;
+    /**
+     * Serializes an transfer for sending in request body.
+     * Uses the configured transferSerializer if provided, otherwise returns the transfer as-is.
+     */
+    private serializeTransfer;
+    /**
+     * Deserializes response data into an transfer.
+     * Uses the configured transferDeserializer if provided, otherwise returns the data as-is.
+     */
+    private deserializeTransfer;
+    /**
+     * Deserializes an array of transfers from response data.
+     */
+    private deserializeArray;
+    /**
+     * Makes a request with optional interceptors.
+     */
+    private request;
+    /**
+     * Gets a template (default values) for creating a new transfer.
+     *
+     * GET /{classPath}/~template
+     */
+    getTemplate(classType: ClassType): Promise<JudoRestResponse<TransferData>>;
+    /**
+     * Refreshes (retrieves) an transfer by its signed identifier.
+     *
+     * POST /{classPath}/~get
+     * Headers: X-Judo-SignedIdentifier
+     */
+    refresh(classType: ClassType, target: TransferStored, queryCustomizer?: QueryCustomizer): Promise<JudoRestResponse<TransferStored>>;
+    /**
+     * Updates an existing transfer.
+     *
+     * POST /{classPath}/~update
+     * Headers: X-Judo-SignedIdentifier, X-Judo-Mask
+     */
+    update(classType: ClassType, target: TransferStored, mask?: string): Promise<JudoRestResponse<TransferStored>>;
+    /**
+     * Validates an transfer update without persisting.
+     *
+     * POST /{classPath}/~validate
+     * Headers: X-Judo-SignedIdentifier
+     */
+    validateUpdate(classType: ClassType, target: TransferStored): Promise<JudoRestResponse<TransferStored>>;
+    /**
+     * Deletes an existing transfer.
+     *
+     * POST /{classPath}/~delete
+     * Headers: X-Judo-SignedIdentifier
+     */
+    delete(classType: ClassType, target: TransferStored): Promise<JudoRestResponse<void>>;
+    /**
+     * Lists transfers in a collection relation.
+     *
+     * POST /{ownerClassPath}/{relationName}/~list
+     * Headers: X-Judo-SignedIdentifier (if owner provided), X-Judo-CountRecords (if countRecords true)
+     */
+    listRelation(relation: RelationType, owner?: TransferStored, queryCustomizer?: QueryCustomizer, countRecords?: boolean): Promise<JudoRestResponse<TransferStored[]>>;
+    /**
+     * Gets a single transfer from a non-collection relation.
+     *
+     * POST /{ownerClassPath}/{relationName}/~get
+     * Headers: X-Judo-SignedIdentifier
+     */
+    getRelation(relation: RelationType, owner: TransferStored, queryCustomizer?: QueryCustomizer): Promise<JudoRestResponse<TransferStored | null>>;
+    /**
+     * Refreshes a non-collection access relation directly.
+     *
+     * POST /{ownerClassPath}/{relationName}/~get
+     * No owner header (access relation)
+     */
+    refreshAccessRelation(relation: RelationType, queryCustomizer?: QueryCustomizer): Promise<JudoRestResponse<TransferStored>>;
+    /**
+     * Gets the available range of transfers for a relation.
+     *
+     * POST /{ownerClassPath}/{relationName}/~range
+     * Headers: X-Judo-Mark-Selected-Range-Items
+     */
+    getRelationRange(relation: RelationType, owner?: TransferStored, queryCustomizer?: QueryCustomizer, countRecords?: boolean): Promise<JudoRestResponse<TransferStored[]>>;
+    /**
+     * Gets template for relation target.
+     *
+     * GET /{targetClassPath}/~template
+     */
+    getRelationTemplate(relation: RelationType): Promise<JudoRestResponse<TransferData>>;
+    /**
+     * Creates a new transfer through a relation.
+     *
+     * Non-access: POST /{ownerClassPath}/~update/{relationName}/~create
+     * Access: POST /{ownerClassPath}/{relationName}/~create
+     */
+    createRelation(relation: RelationType, owner: TransferStored | undefined, data: TransferData, mask?: string): Promise<JudoRestResponse<TransferStored>>;
+    /**
+     * Validates creation through a relation.
+     *
+     * Non-access: POST /{ownerClassPath}/~update/{relationName}/~validate
+     * Access: POST /{ownerClassPath}/{relationName}/~validate
+     */
+    validateCreateRelation(relation: RelationType, owner: TransferStored | undefined, data: TransferData): Promise<JudoRestResponse<TransferData>>;
+    /**
+     * Sets a relation to point to specific transfer/transfers.
+     *
+     * POST /{ownerClassPath}/~update/{relationName}/~set
+     * Headers: X-Judo-SignedIdentifier (non-access only)
+     */
+    setRelation(relation: RelationType, owner: TransferStored, selected: TransferStored | TransferStored[]): Promise<JudoRestResponse<void>>;
+    /**
+     * Clears a relation (sets to null/empty).
+     *
+     * POST /{ownerClassPath}/~update/{relationName}/~unset
+     * Headers: X-Judo-SignedIdentifier (non-access only)
+     */
+    unsetRelation(relation: RelationType, owner: TransferStored): Promise<JudoRestResponse<void>>;
+    /**
+     * Adds transfers to a collection relation.
+     *
+     * POST /{ownerClassPath}/~update/{relationName}/~add
+     * Headers: X-Judo-SignedIdentifier (non-access only)
+     */
+    addToRelation(relation: RelationType, owner: TransferStored, selected: TransferStored[]): Promise<JudoRestResponse<void>>;
+    /**
+     * Removes transfers from a collection relation.
+     *
+     * POST /{ownerClassPath}/~update/{relationName}/~remove
+     * Headers: X-Judo-SignedIdentifier (non-access only)
+     */
+    removeFromRelation(relation: RelationType, owner: TransferStored, selected: TransferStored[]): Promise<JudoRestResponse<void>>;
+    /**
+     * Exports relation data as a file (CSV/Excel).
+     *
+     * POST /{ownerClassPath}/{relationName}/~export
+     * Headers: X-Judo-SignedIdentifier (if owner provided)
+     */
+    exportRelation(relation: RelationType, owner?: TransferStored, queryCustomizer?: QueryCustomizer): Promise<JudoRestResponse<Blob>>;
+    /**
+     * Invokes an operation on an transfer.
+     *
+     * POST /{classPath}/{operationName}
+     * Headers: X-Judo-SignedIdentifier (if mapped/non-static)
+     */
+    invokeOperation<TInput = unknown, TOutput = unknown>(classType: ClassType, operation: OperationInfo, owner?: TransferStored, input?: TInput): Promise<JudoRestResponse<TOutput | undefined>>;
+    /**
+     * Validates operation input without execution.
+     *
+     * POST /{classPath}/{operationName}/~validate
+     * Headers: X-Judo-SignedIdentifier (if mapped/non-static)
+     */
+    validateOperationInput<TInput = unknown>(classType: ClassType, operation: OperationInfo, owner?: TransferStored, input?: TInput): Promise<JudoRestResponse<TInput>>;
+    /**
+     * Gets template for operation input.
+     *
+     * GET /{inputClassPath}/~template
+     */
+    getOperationInputTemplate(operation: OperationInfo): Promise<JudoRestResponse<TransferData>>;
+    /**
+     * Gets range for operation input (selector operations).
+     *
+     * POST /{classPath}/{operationName}/~range
+     * Headers: X-Judo-Mark-Selected-Range-Items
+     */
+    getOperationInputRange(classType: ClassType, operation: OperationInfo, owner?: TransferStored, queryCustomizer?: QueryCustomizer, countRecords?: boolean): Promise<JudoRestResponse<TransferStored[]>>;
+    /**
+     * Gets the current authenticated user's principal data.
+     *
+     * GET /{actorPath}/~principal
+     */
+    getPrincipal(): Promise<JudoRestResponse<TransferStored>>;
+    /**
+     * Gets application metadata.
+     *
+     * GET /{actorPath}/~meta
+     */
+    getMetadata(): Promise<JudoRestResponse<unknown>>;
+    /**
+     * Uploads a file to a binary attribute.
+     *
+     * 1. POST {attributePath}/~upload-token to get token
+     * 2. POST /upload with token and file
+     */
+    uploadFile(attributePath: string, file: File): Promise<JudoRestResponse<unknown>>;
+    /**
+     * Downloads a file from a binary attribute.
+     *
+     * GET /download?disposition={disposition}
+     * Headers: X-Token
+     */
+    downloadFile(downloadToken: string, disposition?: "inline" | "attachment"): Promise<JudoRestResponse<Blob>>;
+    /**
+     * Finds a specific transfer instance from an access relation by identifier.
+     *
+     * POST /{ownerClassPath}/{relationName}/~list
+     * Body: { _identifier, _mask?, _seek: { limit: 1 } }
+     */
+    findInstance(relation: RelationType, identifier: string, mask?: string): Promise<JudoRestResponse<TransferStored | null>>;
+}
+/**
+ * Factory function to create a JUDO REST API client.
+ */
+export declare function createJudoRestApi(config: JudoRestApiConfig): JudoRestApi;
+//# sourceMappingURL=judo-rest-api.d.ts.map

package/dist/api/judo-rest-api.d.ts.map

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

package/dist/api/model-converters.d.ts

@@ -0,0 +1,29 @@
+import { ClassType, OperationType, RelationType } from '@judo/model-api';
+import { ClassTypeMetadata, OperationMetadata, RelationMetadata } from './types';
+/**
+ * Converts a ClassType from the model to ClassTypeMetadata for REST API calls.
+ */
+export declare function toClassTypeMetadata(classType: ClassType): ClassTypeMetadata;
+/**
+ * Converts a RelationType from the model to RelationMetadata for REST API calls.
+ *
+ * @param relation - The RelationType from the model
+ * @param owner - The owner ClassType. If not provided, uses `relation.eContainer`.
+ *                For access relations, you must explicitly pass the actor ClassType.
+ *                For transfer relations, eContainer provides the owner automatically.
+ * @throws Error if owner is not provided and eContainer is not a valid ClassType
+ */
+export declare function toRelationMetadata(relation: RelationType, owner?: ClassType): RelationMetadata;
+/**
+ * Resolves the owner ClassType from a relation's eContainer.
+ * Useful for transfer relations where the owner is the parent ClassType in the EMF model.
+ *
+ * @throws Error if eContainer is not set or is not a ClassType
+ */
+export declare function resolveRelationOwner(relation: RelationType): ClassType;
+/**
+ * Converts an OperationType from the model to OperationMetadata for REST API calls.
+ * Note: OperationTypeEnum values are STATIC (unbound) and MAPPED (bound).
+ */
+export declare function toOperationMetadata(operation: OperationType): OperationMetadata;
+//# sourceMappingURL=model-converters.d.ts.map

package/dist/api/model-converters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-converters.d.ts","sourceRoot":"","sources":["../../src/api/model-converters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEtF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,iBAAiB,CAO3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAW9F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAWtE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,aAAa,GAAG,iBAAiB,CAU/E"}

package/dist/api/path-builder.d.ts

@@ -0,0 +1,50 @@
+import { ClassType, RelationType } from '@judo/model-api';
+import { Application } from '../types';
+/**
+ * Builds a path for the actor with optional additional path segments.
+ *
+ * @param application - The application context
+ * @param path - Optional path to append after the actor path
+ * @returns The full path including model name and actor path
+ */
+export declare function getPathForActor(application: Application, path?: string): string;
+/**
+ * Builds the REST path for a relation with a given suffix.
+ *
+ * @param relation - The relation type
+ * @param application - The application context
+ * @param suffix - The operation suffix (e.g., "/~list", "/~get", "/~range")
+ * @returns The full path for the relation endpoint
+ */
+export declare function getRelationPath(relation: RelationType, application: Application, suffix?: string): string;
+/**
+ * Builds the REST path for a class type with a given suffix.
+ *
+ * @param classType - The class type
+ * @param application - The application context
+ * @param suffix - The operation suffix (e.g., "/~template", "/~get", "/~update")
+ * @returns The full path for the class endpoint
+ */
+export declare function getClassPath(classType: ClassType, application: Application, suffix?: string): string;
+/**
+ * Builds the REST path for a mutation relation operation (create, set, unset, add, remove).
+ * These use the /~update/ prefix for non-access relations.
+ *
+ * @param relation - The relation type
+ * @param application - The application context
+ * @param suffix - The operation suffix (e.g., "/~create", "/~set")
+ * @param isAccess - Whether this is an access relation (skips /~update/ prefix)
+ * @returns The full path for the mutation endpoint
+ */
+export declare function getMutationRelationPath(relation: RelationType, application: Application, suffix: string, isAccess?: boolean): string;
+/**
+ * Builds the REST path for an operation.
+ *
+ * @param classType - The class type containing the operation
+ * @param operationName - The operation name
+ * @param application - The application context
+ * @param suffix - Optional suffix (e.g., "/~validate", "/~range")
+ * @returns The full path for the operation endpoint
+ */
+export declare function getOperationPath(classType: ClassType, operationName: string, application: Application, suffix?: string): string;
+//# sourceMappingURL=path-builder.d.ts.map

package/dist/api/path-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-builder.d.ts","sourceRoot":"","sources":["../../src/api/path-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AA2D5C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,SAAK,GAAG,MAAM,CAK3E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAW,GAAG,MAAM,CAE3G;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAK,GAAG,MAAM,CAEhG;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,QAAQ,UAAQ,GACd,MAAM,CAQR;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,WAAW,EACxB,MAAM,SAAK,GACT,MAAM,CAER"}

package/dist/api/transfer-deserializer.d.ts

@@ -0,0 +1,46 @@
+import { TemporalFieldRegistry, TemporalFieldType, TransferDeserializer } from './types';
+/**
+ * Parse a date-only string (`YYYY-MM-DD`) as a local-timezone `Date`.
+ *
+ * Avoids the timezone-shift problem of `new Date("YYYY-MM-DD")` which creates
+ * a UTC midnight `Date` — displaying as the previous day in negative-offset timezones.
+ *
+ * @param value - Date string in `YYYY-MM-DD` format
+ * @returns `Date` at local midnight, or invalid `Date` if parsing fails
+ */
+export declare function parseLocalDate(value: string): Date;
+/**
+ * Deserialize a temporal string value to its runtime representation.
+ *
+ * - `date` → local-midnight `Date` via {@link parseLocalDate}
+ * - `timestamp` → `Date` via `new Date(isoString)`
+ * - `time` → original string (pass-through)
+ *
+ * @param value - The string value from the API response
+ * @param fieldType - The temporal field type
+ * @returns `Date` for `date`/`timestamp`, original string for `time`
+ */
+export declare function deserializeTemporalValue(value: string, fieldType: TemporalFieldType): Date | string;
+/**
+ * Create a model-aware transfer deserializer that converts temporal fields
+ * from ISO strings to native `Date` objects.
+ *
+ * Uses `__entityType` in the response payload to look up the transfer type
+ * in the provided registry and convert matching fields. Nested objects and
+ * arrays are processed recursively.
+ *
+ * @param registry - Mapping of entity type FQNs to temporal field declarations
+ * @returns `TransferDeserializer` that converts `date`/`timestamp` strings to `Date`
+ *
+ * @example
+ * ```typescript
+ * import { temporalFieldRegistry } from './generated/transfers/_registry';
+ *
+ * const api = createJudoRestApi({
+ *   // ...
+ *   transferDeserializer: createModelAwareDeserializer(temporalFieldRegistry),
+ * });
+ * ```
+ */
+export declare function createModelAwareDeserializer(registry: TemporalFieldRegistry): TransferDeserializer;
+//# sourceMappingURL=transfer-deserializer.d.ts.map

package/dist/api/transfer-deserializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-deserializer.d.ts","sourceRoot":"","sources":["../../src/api/transfer-deserializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE9F;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAKlD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI,GAAG,MAAM,CASnG;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,oBAAoB,CAmClG"}

package/dist/api/transfer-serializer.d.ts

@@ -0,0 +1,85 @@
+import { TemporalFieldRegistry, TemporalFieldType, TransferData, TransferSerializer } from './types';
+/**
+ * Properties provided by the backend that should not be sent in requests.
+ * These are read-only metadata assigned by the server.
+ */
+export declare const BACKEND_PROPERTIES: Set<string>;
+/**
+ * Properties created by the frontend for local state management.
+ * These should never be serialized to the API.
+ */
+export declare const FRONTEND_PROPERTIES: Set<string>;
+/**
+ * Combined set of all internal properties that should not be serialized.
+ */
+export declare const INTERNAL_PROPERTIES: Set<string>;
+/**
+ * Check if a property is internal and should be stripped from serialization.
+ * A property is internal if:
+ * 1. It's in the INTERNAL_PROPERTIES set, OR
+ * 2. It starts with `__` but is NOT `__signedIdentifier`
+ *
+ * @param key - Property name to check
+ * @returns true if the property should be stripped
+ */
+export declare function isInternalProperty(key: string): boolean;
+/**
+ * Strip internal properties from an transfer.
+ * Creates a new object with only non-internal properties.
+ *
+ * @param transfer - Transfer to clean
+ * @returns New object without internal properties
+ */
+export declare function stripInternalProperties<T extends TransferData>(transfer: T): Partial<T>;
+/**
+ * Default transfer serializer that strips internal properties.
+ * Use this when configuring JudoRestApi to ensure internal metadata
+ * is not sent to the server.
+ *
+ * @example
+ * ```typescript
+ * const api = new JudoRestApi({
+ *   baseUrl: 'http://localhost:8080',
+ *   basePath: '/api',
+ *   modelName: 'myapp',
+ *   actorPath: 'admin/Admin',
+ *   transferSerializer: defaultTransferSerializer,
+ * });
+ * ```
+ */
+export declare const defaultTransferSerializer: TransferSerializer;
+/**
+ * Serialize a `Date` value to its wire format based on temporal field type.
+ *
+ * - `date` → `"YYYY-MM-DD"` using **local** date components (avoids timezone shift)
+ * - `timestamp` → full ISO 8601 UTC string via `Date.toISOString()`
+ * - `time` → `"HH:mm:ss"` using local time components
+ *
+ * @param date - The `Date` to serialize
+ * @param fieldType - The temporal field classification
+ * @returns Formatted string for the API wire format
+ */
+export declare function serializeTemporalValue(date: Date, fieldType: TemporalFieldType): string;
+/**
+ * Create a model-aware transfer serializer that converts `Date` objects to
+ * the appropriate wire format **and** strips internal `__*` properties.
+ *
+ * Uses `__entityType` from the transfer (before stripping) to look up
+ * the field type in the registry and format `Date` values accordingly.
+ * Falls back to `Date.toISOString()` for `Date` values on unregistered fields.
+ *
+ * @param registry - Mapping of entity type FQNs to temporal field declarations
+ * @returns `TransferSerializer` that handles Date→string conversion and property stripping
+ *
+ * @example
+ * ```typescript
+ * import { temporalFieldRegistry } from './generated/transfers/_registry';
+ *
+ * const api = createJudoRestApi({
+ *   // ...
+ *   transferSerializer: createModelAwareSerializer(temporalFieldRegistry),
+ * });
+ * ```
+ */
+export declare function createModelAwareSerializer(registry: TemporalFieldRegistry): TransferSerializer;
+//# sourceMappingURL=transfer-serializer.d.ts.map

package/dist/api/transfer-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-serializer.d.ts","sourceRoot":"","sources":["../../src/api/transfer-serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE1G;;;GAGG;AACH,eAAO,MAAM,kBAAkB,aAM7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAAsD,CAAC;AAEvF;;GAEG;AACH,eAAO,MAAM,mBAAmB,aAAmE,CAAC;AAEpG;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAavD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,YAAY,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUvF;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAgBvC,CAAC;AAMF;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAiBvF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,kBAAkB,CA4B9F"}