@voyant-travel/apps 0.1.0

package/dist/app-api-service.d.ts

@@ -0,0 +1,1263 @@
+import type { CustomFieldValueLifecycleRuntime, CustomFieldValueOperationsRuntime } from "@voyant-travel/core/runtime-port";
+import { type CustomFieldDefinitionOwner, createCustomFieldsService } from "@voyant-travel/custom-fields";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { AppApiAuditQuery, AppApiEntityReadQuery, AppApiFinanceActionInput, AppApiFinanceDocumentQuery } from "./app-api-contracts.js";
+export interface AppApiAccessContext {
+    appId: string;
+    installationId: string;
+    releaseId: string;
+    tokenMode: "offline" | "online";
+    viewerId?: string;
+    scopes: readonly string[];
+    apiVersion?: string;
+}
+export interface AppApiEntityReader {
+    list(db: PostgresJsDatabase, query: AppApiEntityReadQuery): Promise<unknown>;
+}
+export interface AppApiFinanceRuntime {
+    listDocuments(db: PostgresJsDatabase, query: AppApiFinanceDocumentQuery): Promise<unknown>;
+    executeAction(db: PostgresJsDatabase, input: AppApiFinanceActionInput): Promise<unknown>;
+}
+export interface AppApiRateLimitPolicy {
+    installationLimit: number;
+    appLimit: number;
+    windowMs: number;
+}
+export interface AppApiServiceOptions {
+    entityReaders?: Readonly<Record<string, AppApiEntityReader>>;
+    finance?: AppApiFinanceRuntime;
+    customFieldTargets?: Parameters<typeof createCustomFieldsService>[0];
+    customFieldValueLifecycles?: readonly CustomFieldValueLifecycleRuntime[];
+    customFieldValueOperations?: readonly CustomFieldValueOperationsRuntime[];
+    rateLimit?: AppApiRateLimitPolicy;
+    now?: () => Date;
+}
+export declare function createAppApiService(options?: AppApiServiceOptions): {
+    introspect: (db: PostgresJsDatabase, context: AppApiAccessContext) => Promise<{
+        data: {
+            installation: {
+                id: string;
+                appId: string;
+                status: "active" | "pending" | "authorizing" | "paused" | "degraded" | "revoked" | "uninstalled";
+                namespace: string;
+                deploymentId: string;
+            };
+            release: {
+                id: string;
+                version: string;
+                apiCompatibility: {
+                    min: string;
+                    max: string;
+                };
+            };
+            grants: {
+                scope: string;
+                status: "optional" | "revoked" | "requested" | "granted";
+                optional: boolean;
+            }[];
+        };
+    }>;
+    listEntities: (db: PostgresJsDatabase, context: AppApiAccessContext, entity: string, query: AppApiEntityReadQuery) => Promise<{
+        data: unknown;
+    }>;
+    listFinanceDocuments: (db: PostgresJsDatabase, context: AppApiAccessContext, query: AppApiFinanceDocumentQuery) => Promise<{
+        data: unknown;
+    }>;
+    executeFinanceAction: (db: PostgresJsDatabase, context: AppApiAccessContext, input: AppApiFinanceActionInput) => Promise<{
+        data: unknown;
+    }>;
+    listCustomFieldDefinitions: (db: PostgresJsDatabase, context: AppApiAccessContext, query: Parameters<NonNullable<{
+        list(db: PostgresJsDatabase, query: import("@voyant-travel/custom-fields").CustomFieldDefinitionListQuery): Promise<{
+            data: {
+                id: string;
+                entityType: string;
+                namespace: string;
+                ownerKind: "platform" | "operator" | "app";
+                ownerId: string | null;
+                lifecycleState: "active" | "inactive" | "deprecated";
+                provenance: Record<string, unknown>;
+                key: string;
+                label: string;
+                fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+                isRequired: boolean;
+                isSearchable: boolean;
+                isExportable: boolean;
+                isInvoiceable: boolean;
+                options: {
+                    label: string;
+                    value: string;
+                }[] | null;
+                createdAt: Date;
+                updatedAt: Date;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        }>;
+        get(db: PostgresJsDatabase, id: string): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        create(db: PostgresJsDatabase, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionInput): Promise<{
+            id: string;
+            namespace: string;
+            label: string;
+            entityType: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        update(db: PostgresJsDatabase, id: string, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionUpdate): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        remove(db: PostgresJsDatabase, id: string): Promise<{
+            id: string;
+        } | null>;
+        listForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, query: import("@voyant-travel/custom-fields").CustomFieldDefinitionListQuery): Promise<{
+            data: {
+                id: string;
+                entityType: string;
+                namespace: string;
+                ownerKind: "platform" | "operator" | "app";
+                ownerId: string | null;
+                lifecycleState: "active" | "inactive" | "deprecated";
+                provenance: Record<string, unknown>;
+                key: string;
+                label: string;
+                fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+                isRequired: boolean;
+                isSearchable: boolean;
+                isExportable: boolean;
+                isInvoiceable: boolean;
+                options: {
+                    label: string;
+                    value: string;
+                }[] | null;
+                createdAt: Date;
+                updatedAt: Date;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        }>;
+        getForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        createForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionInput): Promise<{
+            id: string;
+            namespace: string;
+            label: string;
+            entityType: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        updateForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionUpdate): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        removeForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string): Promise<{
+            id: string;
+        } | null>;
+        values: {
+            listForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, query: import("@voyant-travel/custom-fields").CustomFieldValueListQuery) => Promise<{
+                data: import("@voyant-travel/custom-fields").CustomFieldValueRow[];
+                total: number;
+                limit: number;
+                offset: number;
+            }>;
+            upsertForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, definitionId: string, input: import("@voyant-travel/custom-fields").UpsertCustomFieldValueInput) => Promise<import("@voyant-travel/custom-fields").CustomFieldValueRow>;
+            deleteForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string) => Promise<{
+                id: string;
+            } | null>;
+        };
+    } | undefined>["listForOwner"]>[2]) => Promise<{
+        data: {
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    createCustomFieldDefinition: (db: PostgresJsDatabase, context: AppApiAccessContext, namespace: string | undefined, input: Parameters<NonNullable<{
+        list(db: PostgresJsDatabase, query: import("@voyant-travel/custom-fields").CustomFieldDefinitionListQuery): Promise<{
+            data: {
+                id: string;
+                entityType: string;
+                namespace: string;
+                ownerKind: "platform" | "operator" | "app";
+                ownerId: string | null;
+                lifecycleState: "active" | "inactive" | "deprecated";
+                provenance: Record<string, unknown>;
+                key: string;
+                label: string;
+                fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+                isRequired: boolean;
+                isSearchable: boolean;
+                isExportable: boolean;
+                isInvoiceable: boolean;
+                options: {
+                    label: string;
+                    value: string;
+                }[] | null;
+                createdAt: Date;
+                updatedAt: Date;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        }>;
+        get(db: PostgresJsDatabase, id: string): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        create(db: PostgresJsDatabase, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionInput): Promise<{
+            id: string;
+            namespace: string;
+            label: string;
+            entityType: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        update(db: PostgresJsDatabase, id: string, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionUpdate): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        remove(db: PostgresJsDatabase, id: string): Promise<{
+            id: string;
+        } | null>;
+        listForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, query: import("@voyant-travel/custom-fields").CustomFieldDefinitionListQuery): Promise<{
+            data: {
+                id: string;
+                entityType: string;
+                namespace: string;
+                ownerKind: "platform" | "operator" | "app";
+                ownerId: string | null;
+                lifecycleState: "active" | "inactive" | "deprecated";
+                provenance: Record<string, unknown>;
+                key: string;
+                label: string;
+                fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+                isRequired: boolean;
+                isSearchable: boolean;
+                isExportable: boolean;
+                isInvoiceable: boolean;
+                options: {
+                    label: string;
+                    value: string;
+                }[] | null;
+                createdAt: Date;
+                updatedAt: Date;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        }>;
+        getForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        createForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionInput): Promise<{
+            id: string;
+            namespace: string;
+            label: string;
+            entityType: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        updateForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionUpdate): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        removeForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string): Promise<{
+            id: string;
+        } | null>;
+        values: {
+            listForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, query: import("@voyant-travel/custom-fields").CustomFieldValueListQuery) => Promise<{
+                data: import("@voyant-travel/custom-fields").CustomFieldValueRow[];
+                total: number;
+                limit: number;
+                offset: number;
+            }>;
+            upsertForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, definitionId: string, input: import("@voyant-travel/custom-fields").UpsertCustomFieldValueInput) => Promise<import("@voyant-travel/custom-fields").CustomFieldValueRow>;
+            deleteForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string) => Promise<{
+                id: string;
+            } | null>;
+        };
+    } | undefined>["createForOwner"]>[2]) => Promise<{
+        data: {
+            id: string;
+            namespace: string;
+            label: string;
+            entityType: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        };
+    }>;
+    updateCustomFieldDefinition: (db: PostgresJsDatabase, context: AppApiAccessContext, id: string, namespace: string | undefined, input: Parameters<NonNullable<{
+        list(db: PostgresJsDatabase, query: import("@voyant-travel/custom-fields").CustomFieldDefinitionListQuery): Promise<{
+            data: {
+                id: string;
+                entityType: string;
+                namespace: string;
+                ownerKind: "platform" | "operator" | "app";
+                ownerId: string | null;
+                lifecycleState: "active" | "inactive" | "deprecated";
+                provenance: Record<string, unknown>;
+                key: string;
+                label: string;
+                fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+                isRequired: boolean;
+                isSearchable: boolean;
+                isExportable: boolean;
+                isInvoiceable: boolean;
+                options: {
+                    label: string;
+                    value: string;
+                }[] | null;
+                createdAt: Date;
+                updatedAt: Date;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        }>;
+        get(db: PostgresJsDatabase, id: string): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        create(db: PostgresJsDatabase, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionInput): Promise<{
+            id: string;
+            namespace: string;
+            label: string;
+            entityType: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        update(db: PostgresJsDatabase, id: string, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionUpdate): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        remove(db: PostgresJsDatabase, id: string): Promise<{
+            id: string;
+        } | null>;
+        listForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, query: import("@voyant-travel/custom-fields").CustomFieldDefinitionListQuery): Promise<{
+            data: {
+                id: string;
+                entityType: string;
+                namespace: string;
+                ownerKind: "platform" | "operator" | "app";
+                ownerId: string | null;
+                lifecycleState: "active" | "inactive" | "deprecated";
+                provenance: Record<string, unknown>;
+                key: string;
+                label: string;
+                fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+                isRequired: boolean;
+                isSearchable: boolean;
+                isExportable: boolean;
+                isInvoiceable: boolean;
+                options: {
+                    label: string;
+                    value: string;
+                }[] | null;
+                createdAt: Date;
+                updatedAt: Date;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        }>;
+        getForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        createForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionInput): Promise<{
+            id: string;
+            namespace: string;
+            label: string;
+            entityType: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        updateForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionUpdate): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        removeForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string): Promise<{
+            id: string;
+        } | null>;
+        values: {
+            listForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, query: import("@voyant-travel/custom-fields").CustomFieldValueListQuery) => Promise<{
+                data: import("@voyant-travel/custom-fields").CustomFieldValueRow[];
+                total: number;
+                limit: number;
+                offset: number;
+            }>;
+            upsertForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, definitionId: string, input: import("@voyant-travel/custom-fields").UpsertCustomFieldValueInput) => Promise<import("@voyant-travel/custom-fields").CustomFieldValueRow>;
+            deleteForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string) => Promise<{
+                id: string;
+            } | null>;
+        };
+    } | undefined>["updateForOwner"]>[3]) => Promise<{
+        data: {
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        };
+    }>;
+    listCustomFieldValues: (db: PostgresJsDatabase, context: AppApiAccessContext, query: Parameters<NonNullable<{
+        list(db: PostgresJsDatabase, query: import("@voyant-travel/custom-fields").CustomFieldDefinitionListQuery): Promise<{
+            data: {
+                id: string;
+                entityType: string;
+                namespace: string;
+                ownerKind: "platform" | "operator" | "app";
+                ownerId: string | null;
+                lifecycleState: "active" | "inactive" | "deprecated";
+                provenance: Record<string, unknown>;
+                key: string;
+                label: string;
+                fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+                isRequired: boolean;
+                isSearchable: boolean;
+                isExportable: boolean;
+                isInvoiceable: boolean;
+                options: {
+                    label: string;
+                    value: string;
+                }[] | null;
+                createdAt: Date;
+                updatedAt: Date;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        }>;
+        get(db: PostgresJsDatabase, id: string): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        create(db: PostgresJsDatabase, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionInput): Promise<{
+            id: string;
+            namespace: string;
+            label: string;
+            entityType: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        update(db: PostgresJsDatabase, id: string, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionUpdate): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        remove(db: PostgresJsDatabase, id: string): Promise<{
+            id: string;
+        } | null>;
+        listForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, query: import("@voyant-travel/custom-fields").CustomFieldDefinitionListQuery): Promise<{
+            data: {
+                id: string;
+                entityType: string;
+                namespace: string;
+                ownerKind: "platform" | "operator" | "app";
+                ownerId: string | null;
+                lifecycleState: "active" | "inactive" | "deprecated";
+                provenance: Record<string, unknown>;
+                key: string;
+                label: string;
+                fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+                isRequired: boolean;
+                isSearchable: boolean;
+                isExportable: boolean;
+                isInvoiceable: boolean;
+                options: {
+                    label: string;
+                    value: string;
+                }[] | null;
+                createdAt: Date;
+                updatedAt: Date;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        }>;
+        getForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        createForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionInput): Promise<{
+            id: string;
+            namespace: string;
+            label: string;
+            entityType: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        updateForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionUpdate): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        removeForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string): Promise<{
+            id: string;
+        } | null>;
+        values: {
+            listForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, query: import("@voyant-travel/custom-fields").CustomFieldValueListQuery) => Promise<{
+                data: import("@voyant-travel/custom-fields").CustomFieldValueRow[];
+                total: number;
+                limit: number;
+                offset: number;
+            }>;
+            upsertForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, definitionId: string, input: import("@voyant-travel/custom-fields").UpsertCustomFieldValueInput) => Promise<import("@voyant-travel/custom-fields").CustomFieldValueRow>;
+            deleteForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string) => Promise<{
+                id: string;
+            } | null>;
+        };
+    } | undefined>["values"]["listForOwner"]>[2]) => Promise<{
+        data: import("@voyant-travel/custom-fields").CustomFieldValueRow[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    upsertCustomFieldValue: (db: PostgresJsDatabase, context: AppApiAccessContext, definitionId: string, input: Parameters<NonNullable<{
+        list(db: PostgresJsDatabase, query: import("@voyant-travel/custom-fields").CustomFieldDefinitionListQuery): Promise<{
+            data: {
+                id: string;
+                entityType: string;
+                namespace: string;
+                ownerKind: "platform" | "operator" | "app";
+                ownerId: string | null;
+                lifecycleState: "active" | "inactive" | "deprecated";
+                provenance: Record<string, unknown>;
+                key: string;
+                label: string;
+                fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+                isRequired: boolean;
+                isSearchable: boolean;
+                isExportable: boolean;
+                isInvoiceable: boolean;
+                options: {
+                    label: string;
+                    value: string;
+                }[] | null;
+                createdAt: Date;
+                updatedAt: Date;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        }>;
+        get(db: PostgresJsDatabase, id: string): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        create(db: PostgresJsDatabase, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionInput): Promise<{
+            id: string;
+            namespace: string;
+            label: string;
+            entityType: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        update(db: PostgresJsDatabase, id: string, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionUpdate): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        remove(db: PostgresJsDatabase, id: string): Promise<{
+            id: string;
+        } | null>;
+        listForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, query: import("@voyant-travel/custom-fields").CustomFieldDefinitionListQuery): Promise<{
+            data: {
+                id: string;
+                entityType: string;
+                namespace: string;
+                ownerKind: "platform" | "operator" | "app";
+                ownerId: string | null;
+                lifecycleState: "active" | "inactive" | "deprecated";
+                provenance: Record<string, unknown>;
+                key: string;
+                label: string;
+                fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+                isRequired: boolean;
+                isSearchable: boolean;
+                isExportable: boolean;
+                isInvoiceable: boolean;
+                options: {
+                    label: string;
+                    value: string;
+                }[] | null;
+                createdAt: Date;
+                updatedAt: Date;
+            }[];
+            total: number;
+            limit: number;
+            offset: number;
+        }>;
+        getForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        createForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionInput): Promise<{
+            id: string;
+            namespace: string;
+            label: string;
+            entityType: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        updateForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string, input: import("@voyant-travel/custom-fields").CustomFieldDefinitionUpdate): Promise<{
+            id: string;
+            entityType: string;
+            namespace: string;
+            ownerKind: "platform" | "operator" | "app";
+            ownerId: string | null;
+            lifecycleState: "active" | "inactive" | "deprecated";
+            provenance: Record<string, unknown>;
+            key: string;
+            label: string;
+            fieldType: "boolean" | "varchar" | "text" | "double" | "monetary" | "date" | "enum" | "set" | "json" | "address" | "phone";
+            isRequired: boolean;
+            isSearchable: boolean;
+            isExportable: boolean;
+            isInvoiceable: boolean;
+            options: {
+                label: string;
+                value: string;
+            }[] | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        removeForOwner(db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string): Promise<{
+            id: string;
+        } | null>;
+        values: {
+            listForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, query: import("@voyant-travel/custom-fields").CustomFieldValueListQuery) => Promise<{
+                data: import("@voyant-travel/custom-fields").CustomFieldValueRow[];
+                total: number;
+                limit: number;
+                offset: number;
+            }>;
+            upsertForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, definitionId: string, input: import("@voyant-travel/custom-fields").UpsertCustomFieldValueInput) => Promise<import("@voyant-travel/custom-fields").CustomFieldValueRow>;
+            deleteForOwner: (db: PostgresJsDatabase, owner: CustomFieldDefinitionOwner, id: string) => Promise<{
+                id: string;
+            } | null>;
+        };
+    } | undefined>["values"]["upsertForOwner"]>[3]) => Promise<{
+        data: import("@voyant-travel/custom-fields").CustomFieldValueRow;
+    }>;
+    listWebhookHealth: (db: PostgresJsDatabase, context: AppApiAccessContext) => Promise<{
+        data: {
+            id: string;
+            installationId: string;
+            releaseId: string;
+            eventType: string;
+            eventVersion: string;
+            endpointUrl: string;
+            status: "active" | "inactive" | "failed";
+            externalSubscriptionId: string | null;
+            signingKeyId: string | null;
+            lastDeliveryAt: Date | null;
+            failureCount: number;
+            pausedAt: Date | null;
+            installedAt: Date;
+            deactivatedAt: Date | null;
+        }[];
+    }>;
+    listAuditHistory: (db: PostgresJsDatabase, context: AppApiAccessContext, query: AppApiAuditQuery) => Promise<{
+        data: {
+            id: string;
+            installationId: string | null;
+            appId: string;
+            deploymentId: string;
+            actorId: string;
+            kind: "lifecycle" | "grant" | "consent" | "credential" | "token" | "reconciliation" | "purge";
+            action: string;
+            details: Record<string, unknown>;
+            createdAt: Date;
+        }[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    requireAccess: (db: PostgresJsDatabase, context: AppApiAccessContext, requiredScopes: readonly string[]) => Promise<{
+        installation: {
+            id: string;
+            appId: string;
+            deploymentId: string;
+            releaseId: string;
+            status: "active" | "pending" | "authorizing" | "paused" | "degraded" | "revoked" | "uninstalled";
+            namespace: string;
+            installedBy: string;
+            credentialGeneration: number;
+            updatePolicy: "manual" | "compatible" | "patch" | "pinned";
+            lastCompatibleReleaseCheckAt: Date | null;
+            pendingReleaseId: string | null;
+            pendingReason: string | null;
+            installedAt: Date;
+            authorizedAt: Date | null;
+            activatedAt: Date | null;
+            pausedAt: Date | null;
+            degradedAt: Date | null;
+            revokedAt: Date | null;
+            uninstalledAt: Date | null;
+            purgedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+        };
+        release: {
+            id: string;
+            appId: string;
+            releaseVersion: string;
+            manifestSchemaVersion: string;
+            manifestDigest: string;
+            manifestSnapshot: Record<string, unknown>;
+            normalizedRecord: Record<string, unknown>;
+            apiCompatibility: {
+                min: string;
+                max: string;
+            };
+            defaultLocale: string;
+            supportedLocales: string[];
+            state: "suspended" | "available" | "yanked";
+            createdBy: string;
+            createdAt: Date;
+        };
+    }>;
+    enforceRateLimit: (context: AppApiAccessContext) => void;
+};
+export declare function assertAppNamespaceAlias(namespace: string | undefined): void;
+export declare function assertCompatibleVersion(requested: string, range: {
+    min: string;
+    max: string;
+}): void;
+export declare function withAppApiDeadline<T>(promise: Promise<T>, timeoutMs?: number): Promise<T>;