@collective-intelligence/external-apps-server-sdk 0.0.0-stage → 0.1.0

package/dist/knowledge-sources/payload.d.ts

@@ -0,0 +1,420 @@
+// Generated by dts-bundle-generator v9.5.1
+
+export type ResourceJsonValue = null | boolean | number | string | readonly ResourceJsonValue[] | Readonly<{
+	[key: string]: ResourceJsonValue;
+}>;
+/** Opaque wire identity. Callers must not infer or concatenate its internals. */
+export type ResourceId = string;
+export type ResourceRecordId = ResourceId;
+/** Opaque concurrency token independent from source timestamps. */
+export type ResourceRevision = string;
+/** Opaque pagination position issued and consumed only by a resource adapter. */
+export type ResourceCursor = string;
+export type IdempotencyKey = string;
+export type ResourceIdentityField = Readonly<{
+	name: string;
+	type: "number" | "string";
+}>;
+export type ResourceCapabilities = Readonly<{
+	create?: boolean;
+	/** Common entity deletion is always soft deletion. */
+	delete?: boolean;
+	get?: boolean;
+	hardDelete?: boolean;
+	includeDeleted?: boolean;
+	restore?: boolean;
+	search: true;
+	softDelete?: boolean;
+	update?: boolean;
+}>;
+export type ResourcePaginationMode = "cursor" | "page";
+export type PortableResourceSchema = Readonly<Record<string, ResourceJsonValue>>;
+export type ResourceDefinition<Entity, Create = Entity, Update = Partial<Entity>> = Readonly<{
+	capabilities: ResourceCapabilities;
+	concurrency: "revision";
+	id: string;
+	identity: Readonly<{
+		fields: readonly [
+			ResourceIdentityField,
+			...ResourceIdentityField[]
+		];
+	}>;
+	query: Readonly<{
+		filterableFields: readonly string[];
+		pagination: Readonly<{
+			modes: readonly ResourcePaginationMode[];
+		}>;
+		sortableFields: readonly string[];
+		textSearchFields?: readonly string[];
+	}>;
+	schemas: Readonly<{
+		create?: PortableResourceSchema;
+		entity: PortableResourceSchema;
+		update?: PortableResourceSchema;
+	}>;
+	version: string;
+	/** Portable UI metadata; required/enum/nullability remain in schemas. */
+	metadata?: Readonly<Record<string, ResourceJsonValue>>;
+	/** Type-only slots keep definition values portable and serializable. */
+	readonly __types?: Readonly<{
+		create: Create;
+		entity: Entity;
+		update: Update;
+	}>;
+}>;
+export type FilterValue = ResourceJsonValue | readonly ResourceJsonValue[];
+export type ResourceFilter = Readonly<{
+	field: string;
+	operator: "contains" | "ends_with" | "eq" | "gt" | "gte" | "in" | "lt" | "lte" | "ne" | "not_in" | "starts_with";
+	value: FilterValue;
+}> | Readonly<{
+	field: string;
+	operator: "is_not_null" | "is_null";
+}> | Readonly<{
+	filters: readonly ResourceFilter[];
+	operator: "and" | "or";
+}> | Readonly<{
+	filter: ResourceFilter;
+	operator: "not";
+}>;
+export type ResourceSort = Readonly<{
+	direction: "asc" | "desc";
+	field: string;
+}>;
+export type ResourcePagination = Readonly<{
+	mode: "cursor";
+	cursor?: ResourceCursor;
+	limit: number;
+}> | Readonly<{
+	mode: "page";
+	page: number;
+	pageSize: number;
+}>;
+export type ResourceListQuery = Readonly<{
+	filter?: ResourceFilter;
+	includeDeleted?: boolean;
+	pagination: ResourcePagination;
+	sort?: readonly ResourceSort[];
+	textSearch?: string;
+}>;
+export type ResourceRecord<Entity> = Readonly<{
+	deletedAt?: string;
+	id: ResourceRecordId;
+	revision: ResourceRevision;
+	value: Entity;
+}>;
+export type ResourceErrorCode = "capability_not_supported" | "conflict" | "forbidden" | "internal" | "invalid_request" | "not_found" | "rate_limited" | "transport_error" | "unauthenticated" | "unavailable";
+export type ResourceError = Readonly<{
+	code: ResourceErrorCode;
+	/** Client-observed dispatch outcome; uncertainty never proves rollback. */
+	outcome?: "not_dispatched" | "rejected" | "uncertain";
+	details?: Readonly<Record<string, ResourceJsonValue>>;
+	message: string;
+	retryable: boolean;
+}>;
+export type ResourceResult<Value> = Readonly<{
+	correlationId: string;
+	ok: true;
+	value: Value;
+}> | Readonly<{
+	correlationId: string;
+	error: ResourceError;
+	ok: false;
+}>;
+export type ResourceListRequest = Readonly<{
+	operation: "list";
+	query: ResourceListQuery;
+	requestId: string;
+	resourceId: string;
+}>;
+export type ResourceGetRequest = Readonly<{
+	id: ResourceRecordId;
+	includeDeleted?: boolean;
+	operation: "get";
+	requestId: string;
+	resourceId: string;
+}>;
+export type ResourceCreateRequest<Create> = Readonly<{
+	idempotencyKey: IdempotencyKey;
+	operation: "create";
+	requestId: string;
+	resourceId: string;
+	value: Create;
+}>;
+export type ResourceUpdateRequest<Update> = Readonly<{
+	expectedRevision: ResourceRevision;
+	id: ResourceRecordId;
+	idempotencyKey?: IdempotencyKey;
+	operation: "update";
+	requestId: string;
+	resourceId: string;
+	value: Update;
+}>;
+export type ResourceLifecycleRequest = Readonly<{
+	expectedRevision: ResourceRevision;
+	id: ResourceRecordId;
+	idempotencyKey?: IdempotencyKey;
+	operation: "hard_delete" | "restore" | "soft_delete";
+	requestId: string;
+	resourceId: string;
+}>;
+export type ResourceTransportRequest = ResourceCreateRequest<unknown> | ResourceGetRequest | ResourceLifecycleRequest | ResourceListRequest | ResourceUpdateRequest<unknown>;
+export type PrincipalKind = "detached_user" | "service_principal";
+export type DelegatedSubjectPolicy = "allowed" | "forbidden" | "required";
+export type AuthorizationRequirement = Readonly<{
+	delegatedSubject?: DelegatedSubjectPolicy;
+	organization: "required";
+	principalKinds: readonly PrincipalKind[];
+	scopes: readonly string[];
+}>;
+export type ExternalAuditSubject = Readonly<{
+	issuer: string;
+	mappedCiUserId?: string;
+	subject: string;
+}>;
+export type GatewayCallerIdentity = Readonly<{
+	audience: readonly string[];
+	binding: string;
+	expiresAt: number;
+	installationId: string;
+	issuer: string;
+	organizationId: string;
+	principalKind: PrincipalKind;
+	requestId: string;
+	scopes: readonly string[];
+	subject: string;
+}>;
+export type GatewayInvocationContext = Readonly<{
+	caller: GatewayCallerIdentity;
+	correlationId: string;
+	externalAuditSubject?: ExternalAuditSubject;
+	organizationId: string;
+}>;
+/** Full inventory only: no filters, text search or caller-selected ordering.
+ * Continue consecutive pages with the first watermark. A conflict requires restart.
+ */
+export type ResourceInventoryRequest = Readonly<{
+	page: number;
+	pageSize: number;
+	watermark?: string;
+}>;
+export type GatewayResourceOperation = ResourceTransportRequest["operation"];
+export type GatewayResourceAuthorization = Readonly<Partial<Record<GatewayResourceOperation, AuthorizationRequirement>>>;
+export type GatewayResourceDefinition<Entity = unknown, Create = Entity, Update = Partial<Entity>> = Readonly<{
+	authorization: GatewayResourceAuthorization;
+	definition: ResourceDefinition<Entity, Create, Update>;
+	execute: (request: ResourceTransportRequest, context: GatewayInvocationContext, options?: Readonly<{
+		signal?: AbortSignal;
+	}>) => Promise<ResourceResult<unknown>>;
+	scan?: (request: ResourceInventoryRequest & Readonly<{
+		requestId: string;
+		resourceId: string;
+	}>, context: GatewayInvocationContext, options?: Readonly<{
+		signal?: AbortSignal;
+	}>) => Promise<ResourceResult<unknown>>;
+	changes?: (request: Readonly<{
+		cursor?: string;
+		limit: number;
+		requestId: string;
+		resourceId: string;
+	}>, context: GatewayInvocationContext, options?: Readonly<{
+		signal?: AbortSignal;
+	}>) => Promise<ResourceResult<unknown>>;
+}>;
+export type NativeRecord = Readonly<Record<string, ResourceJsonValue>>;
+export type DataSourceKind = "drizzle_postgresql" | "payload" | "strapi";
+export type DataSourceCapabilities = Readonly<{
+	create: boolean;
+	hardDelete: boolean;
+	incrementalChanges: boolean;
+	nativePolicy: boolean;
+	pagination: readonly ("cursor" | "page")[];
+	read: true;
+	relations: boolean;
+	restore: boolean;
+	softDelete: boolean;
+	transactions: boolean;
+	update: boolean;
+}>;
+export type DataSourceRelation = Readonly<{
+	cardinality: "many" | "one";
+	field: string;
+	targetIdentityFields: readonly [
+		string,
+		...string[]
+	];
+	targetResourceId: string;
+}>;
+export type DataSourceProjection = Readonly<{
+	fields: readonly string[];
+	redact?: readonly string[];
+	relations?: readonly DataSourceRelation[];
+}>;
+export type DataSourceChange<Entity> = Readonly<{
+	kind: "tombstone";
+	deletedAt: string;
+	id: string;
+	revision: string;
+}> | Readonly<{
+	kind: "upsert";
+	record: ResourceRecord<Entity>;
+}>;
+export type DataSourceChangePage<Entity> = Readonly<{
+	changes: readonly DataSourceChange<Entity>[];
+	nextCursor?: string;
+}>;
+export type NativeChange = Readonly<{
+	deletedAt: string;
+	identity: NativeRecord;
+	kind: "tombstone";
+	revision: string;
+	updatedAt: string;
+}> | Readonly<{
+	kind: "upsert";
+	row: NativeRecord;
+}>;
+export type NativeChangePage = Readonly<{
+	changes: readonly NativeChange[];
+}>;
+export type DataSourceAdapter<Entity = NativeRecord> = GatewayResourceDefinition<Entity> & Readonly<{
+	dataSource: Readonly<{
+		capabilities: DataSourceCapabilities;
+		kind: DataSourceKind;
+	}>;
+}>;
+export type DataSourceBaseOptions<Entity = NativeRecord> = Readonly<{
+	authorization: GatewayResourceAuthorization;
+	capabilities: DataSourceCapabilities;
+	definition: ResourceDefinition<Entity>;
+	identity: Readonly<{
+		fields: readonly [
+			string,
+			...string[]
+		];
+	}>;
+	maxPageSize?: number;
+	projection: DataSourceProjection;
+	revision: (record: NativeRecord) => string;
+	softDelete?: Readonly<{
+		deletedAt: (record: NativeRecord) => string | undefined;
+	}>;
+	updatedAt: (record: NativeRecord) => string;
+}>;
+export type DataSourceMappingErrorCode = "capability_mismatch" | "duplicate_field" | "invalid_identity" | "invalid_pagination" | "unsupported_mapping";
+export declare class DataSourceMappingError extends TypeError {
+	readonly code: DataSourceMappingErrorCode;
+	constructor(code: DataSourceMappingErrorCode, message: string);
+}
+export type PayloadOpaqueValue = object | null;
+export type PayloadWhere = Readonly<Record<string, ResourceJsonValue>>;
+export type PayloadCallContext = Readonly<{
+	overrideAccess: false;
+	req?: PayloadOpaqueValue;
+	user: PayloadOpaqueValue;
+}>;
+export interface PayloadLocalApi {
+	readonly create: (input: PayloadCallContext & Readonly<{
+		collection: string;
+		data: ResourceJsonValue;
+		draft: boolean;
+		locale?: string;
+	}>) => Promise<NativeRecord>;
+	readonly delete: (input: PayloadCallContext & Readonly<{
+		collection: string;
+		id: number | string;
+		locale?: string;
+	}>) => Promise<NativeRecord>;
+	readonly find: (input: PayloadCallContext & Readonly<{
+		collection: string;
+		draft: boolean;
+		limit: number;
+		locale?: string;
+		page: number;
+		sort?: readonly string[];
+		where?: PayloadWhere;
+	}>) => Promise<Readonly<{
+		docs: readonly NativeRecord[];
+		page?: number;
+		totalDocs: number;
+		totalPages: number;
+	}>>;
+	readonly findByID: (input: PayloadCallContext & Readonly<{
+		collection: string;
+		draft: boolean;
+		id: number | string;
+		locale?: string;
+	}>) => Promise<NativeRecord | null>;
+	readonly findGlobal?: (input: PayloadCallContext & Readonly<{
+		draft: boolean;
+		locale?: string;
+		slug: string;
+	}>) => Promise<NativeRecord>;
+	readonly update: (input: PayloadCallContext & Readonly<{
+		collection: string;
+		data: ResourceJsonValue;
+		draft: boolean;
+		id: number | string;
+		locale?: string;
+	}>) => Promise<NativeRecord>;
+	readonly updateGlobal?: (input: PayloadCallContext & Readonly<{
+		data: ResourceJsonValue;
+		draft: boolean;
+		locale?: string;
+		slug: string;
+	}>) => Promise<NativeRecord>;
+}
+export type PayloadGatewayHooks = Readonly<{
+	changes?: (input: {
+		after?: Readonly<{
+			externalId: string;
+			updatedAt: string;
+		}>;
+		collection: string;
+		limit: number;
+		locale?: string;
+		organizationId: string;
+		overlapMs: number;
+		signal?: AbortSignal;
+		user: PayloadOpaqueValue;
+	}) => Promise<NativeChangePage>;
+	hardDelete?: (input: {
+		collection: string;
+		id: number | string;
+		locale?: string;
+		organizationId: string;
+		signal?: AbortSignal;
+		user: PayloadOpaqueValue;
+	}) => Promise<void>;
+	restore?: (input: {
+		collection: string;
+		id: number | string;
+		locale?: string;
+		organizationId: string;
+		signal?: AbortSignal;
+		user: PayloadOpaqueValue;
+	}) => Promise<NativeRecord>;
+}>;
+export type PayloadSourceOptions<Entity = NativeRecord> = DataSourceBaseOptions<Entity> & Readonly<{
+	collection: string;
+	includeDrafts?: boolean;
+	incrementalChanges?: Readonly<{
+		overlapMs?: number;
+	}>;
+	local: PayloadLocalApi;
+	locale?: string;
+	localeField?: string;
+	nativeRequest?: (context: Parameters<DataSourceAdapter["execute"]>[1]) => PayloadOpaqueValue;
+	plugin?: PayloadGatewayHooks;
+	user: (context: Parameters<DataSourceAdapter["execute"]>[1]) => PayloadOpaqueValue;
+}>;
+export type PayloadGlobalSourceOptions<Entity = NativeRecord> = DataSourceBaseOptions<Entity> & Readonly<{
+	global: string;
+	includeDrafts?: boolean;
+	local: PayloadLocalApi & Required<Pick<PayloadLocalApi, "findGlobal" | "updateGlobal">>;
+	locale?: string;
+	nativeRequest?: (context: Parameters<DataSourceAdapter["execute"]>[1]) => PayloadOpaqueValue;
+	user: (context: Parameters<DataSourceAdapter["execute"]>[1]) => PayloadOpaqueValue;
+}>;
+export declare const definePayloadGatewayPlugin: (hooks: PayloadGatewayHooks) => PayloadGatewayHooks, definePayloadGlobalSource: <Entity = Readonly<Record<string, ResourceJsonValue>>>(options: PayloadGlobalSourceOptions<Entity>) => DataSourceAdapter<Entity>, definePayloadSource: <Entity = Readonly<Record<string, ResourceJsonValue>>>(options: PayloadSourceOptions<Entity>) => DataSourceAdapter<Entity>;
+
+export {};

package/dist/knowledge-sources/payload.js

@@ -0,0 +1 @@
+var __defProp=Object.defineProperty;var __returnValue=(v)=>v;function __exportSetter(name,newValue){this[name]=__returnValue.bind(null,newValue)}var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:true,configurable:true,set:__exportSetter.bind(all,name)})};var exports_payload={};__export(exports_payload,{definePayloadSource:()=>definePayloadSource,definePayloadGlobalSource:()=>definePayloadGlobalSource,definePayloadGatewayPlugin:()=>definePayloadGatewayPlugin});var resourceCapabilityByOperation={create:"create",get:"get",hard_delete:"hardDelete",list:"search",restore:"restore",soft_delete:"softDelete",update:"update"};class DataSourceMappingError extends TypeError{code;constructor(code,message){super(message);this.name="DataSourceMappingError";this.code=code}}var isJsonValue=(value)=>{if(value===null||typeof value==="boolean"||typeof value==="number"||typeof value==="string"){return true}if(Array.isArray(value)){return value.every(isJsonValue)}if(typeof value!=="object"||value===null){return false}const prototype=Object.getPrototypeOf(value);if(prototype!==Object.prototype&&prototype!==null){return false}return Object.values(value).every(isJsonValue)};var parseJsonValue=(value)=>{if(!isJsonValue(value)){throw new DataSourceMappingError("unsupported_mapping","Value must be JSON-compatible")}return value};var encode=(prefix,value)=>`${prefix}.${Buffer.from(JSON.stringify(value)).toString("base64url")}`;var decode=(prefix,value)=>{if(!value.startsWith(`${prefix}.`)){throw new DataSourceMappingError("invalid_identity",`Expected an opaque ${prefix} identifier`)}try{const parsed=JSON.parse(Buffer.from(value.slice(prefix.length+1),"base64url").toString("utf-8"));if(!isJsonValue(parsed)){throw new DataSourceMappingError("invalid_identity",`Invalid opaque ${prefix} identifier`)}return parsed}catch{throw new DataSourceMappingError("invalid_identity",`Invalid opaque ${prefix} identifier`)}};var opaqueIdentity=(kind,fields,record)=>{const values=fields.map((field)=>{const value=record[field];if(typeof value!=="string"&&typeof value!=="number"){throw new DataSourceMappingError("invalid_identity",`Identity field ${field} must be a string or number`)}return value});return encode(`${kind}:id`,values)};var decodeIdentity=(kind,fields,id)=>{const values=decode(`${kind}:id`,id);if(!Array.isArray(values)||values.length!==fields.length){throw new DataSourceMappingError("invalid_identity","Opaque identifier does not match the configured identity")}return Object.fromEntries(fields.map((field,index)=>[field,values[index]]))};var opaqueRevision=(kind,revision)=>encode(`${kind}:rev`,revision);var nativeIdentifier=(value)=>{if(typeof value!=="string"&&typeof value!=="number"){throw new DataSourceMappingError("invalid_identity","Identity value must be a string or number")}return value};var optionalNativeString=(value)=>typeof value==="string"?value:undefined;var cursor=(kind,value)=>encode(`${kind}:cursor`,value);var decodeCursor=(kind,value)=>decode(`${kind}:cursor`,value);var projectedRelation=(kind,relation,value)=>{const normalize=(record)=>{if(typeof record!=="object"||record===null){throw new DataSourceMappingError("unsupported_mapping",`Relation ${relation.field} requires an object identity`)}const nativeRecord=Object.fromEntries(Object.entries(record));return opaqueIdentity(`${kind}:${relation.targetResourceId}`,relation.targetIdentityFields,nativeRecord)};if(relation.cardinality==="many"){if(!Array.isArray(value)){throw new DataSourceMappingError("unsupported_mapping",`Relation ${relation.field} requires an array`)}return value.map(normalize)}return value===null||value===undefined?null:normalize(value)};var project=(kind,projection,row)=>{const redacted=new Set(projection.redact);const relations=new Map((projection.relations??[]).map((relation)=>[relation.field,relation]));const entries=[];for(const field of projection.fields){if(redacted.has(field)){continue}const value=row[field];const relation=relations.get(field);if(relation!==undefined){entries.push([field,projectedRelation(kind,relation,value)]);continue}if(value===undefined){continue}if(!isJsonValue(value)){throw new DataSourceMappingError("unsupported_mapping",`Field ${field} is not JSON-compatible`)}entries.push([field,value])}return Object.fromEntries(entries)};var record=(kind,options,row)=>{const deletedAt=options.softDelete?.deletedAt(row);const result={id:opaqueIdentity(kind,options.identity.fields,row),revision:opaqueRevision(kind,options.revision(row)),value:project(kind,options.projection,row)};if(deletedAt!==undefined){result.deletedAt=deletedAt}return result};var success=(correlationId,value)=>({correlationId,ok:true,value});var failure=(correlationId,error)=>({correlationId,error,ok:false});var nativeFilterOperator=(operator)=>operator.replaceAll(/_(?<letter>[a-z])/gu,(_match,letter)=>letter.toUpperCase());var unsupportedOperation=(correlationId,capabilities,operation)=>{const capability=resourceCapabilityByOperation[operation];if(capabilities[capability]===true){return}return failure(correlationId,{code:"capability_not_supported",details:{capability},message:`The data source does not support ${capability}`,retryable:false})};var conflict=(correlationId)=>failure(correlationId,{code:"conflict",message:"The expected revision does not match the current record",retryable:false});var invalid=(correlationId,cause)=>failure(correlationId,{code:"invalid_request",details:{cause:cause instanceof Error?cause.message:String(cause)},message:"The data-source request is invalid",retryable:false});var nativeFailure=(correlationId,cause)=>failure(correlationId,{code:"internal",details:{cause:cause instanceof Error?cause.message:String(cause)},message:"The native data source failed",retryable:false});var assertConfiguration=(options)=>{const fields=[...options.projection.fields,...options.projection.redact??[]];if(new Set(fields).size!==fields.length){throw new DataSourceMappingError("duplicate_field","Exposed and redacted fields must be disjoint and unique")}const maxPageSize=options.maxPageSize??100;if(!Number.isSafeInteger(maxPageSize)||maxPageSize<1){throw new DataSourceMappingError("invalid_pagination","maxPageSize must be a positive safe integer")}if(options.capabilities.pagination.length===0){throw new DataSourceMappingError("invalid_pagination","At least one pagination mode must be declared")}const declaredPagination=new Set(options.definition.query.pagination.modes);if(declaredPagination.size!==options.capabilities.pagination.length||options.capabilities.pagination.some((mode)=>!declaredPagination.has(mode))){throw new DataSourceMappingError("capability_mismatch","Data-source pagination must match the resource definition")}if(options.capabilities.relations!==(options.projection.relations?.length??0)>0){throw new DataSourceMappingError("capability_mismatch","Relation capability must match the explicit relation projection")}for(const capability of["create","hardDelete","restore","softDelete","update"]){if(options.capabilities[capability]!==(options.definition.capabilities[capability]===true)){throw new DataSourceMappingError("capability_mismatch",`${capability} capability must match the resource definition`)}}};var boundedLimit=(requested,maximum=100)=>{if(!Number.isSafeInteger(requested)||requested<1){throw new DataSourceMappingError("invalid_pagination","Page size must be a positive safe integer")}return Math.min(requested,maximum)};var expectedRevisionMatches=(kind,options,row,expectedRevision)=>opaqueRevision(kind,options.revision(row))===expectedRevision;var kind="payload";var optionalProperty=(key,value)=>value===undefined?{}:{[key]:value};var payloadWhere=(filter)=>{if(filter===undefined){return}if("filters"in filter){const filters=filter.filters.map(payloadWhere).filter((where)=>where!==undefined);return{[filter.operator]:filters}}if("filter"in filter){const nested=payloadWhere(filter.filter);return nested===undefined?undefined:{not:nested}}if(filter.operator==="is_null"){return{[filter.field]:{exists:false}}}if(filter.operator==="is_not_null"){return{[filter.field]:{exists:true}}}if(!("value"in filter)){return}const{operator:filterOperator,value:filterValue}=filter;const operator=nativeFilterOperator(filterOperator);let patternValue;if(filterOperator==="starts_with"||filterOperator==="ends_with"){try{patternValue=String(nativeIdentifier(filterValue))}catch{throw new TypeError(`${filterOperator} requires a string or number`)}}if((filterOperator==="starts_with"||filterOperator==="ends_with")&&patternValue===undefined){throw new TypeError(`${filterOperator} requires a string or number`)}let value;if(filterOperator==="starts_with"){value=`${patternValue}%`}else if(filterOperator==="ends_with"){value=`%${patternValue}`}else{value=filterValue}return{[filter.field]:{[operator]:value}}};var nativeId=(options,identity)=>{const[firstField]=options.identity.fields;return nativeIdentifier(identity[firstField])};var localeFor=(options,identity)=>{if(options.localeField!==undefined&&identity!==undefined){const value=identity[options.localeField];const localeValue=optionalNativeString(value);if(localeValue!==undefined){return localeValue}}return options.locale};var validatePayload=(options)=>{if(!options.capabilities.nativePolicy){throw new TypeError("Payload must declare nativePolicy support")}if(options.capabilities.transactions||options.capabilities.softDelete!==(options.softDelete!==undefined)){throw new TypeError("Payload transaction and soft-delete capabilities require explicit policy")}if(options.capabilities.hardDelete!==(options.plugin?.hardDelete!==undefined)||options.capabilities.restore!==(options.plugin?.restore!==undefined)||options.capabilities.incrementalChanges!==(options.plugin?.changes!==undefined)){throw new TypeError("Payload capabilities must match installed plugin hooks")}if(options.capabilities.softDelete!==(options.definition.capabilities.softDelete===true)){throw new TypeError("Payload soft-delete capability must match its resource definition")}};var definePayloadSource=(options)=>{assertConfiguration(options);validatePayload(options);const maximum=options.maxPageSize??100;const executeList=async(request,callContext,draft)=>{const{pagination}=request.query;let page=1;if(pagination.mode==="page"){const{page:requestedPage}=pagination;page=requestedPage}else if(pagination.cursor!==undefined){page=decodeCursor(kind,pagination.cursor)}const pageSize=boundedLimit(pagination.mode==="page"?pagination.pageSize:pagination.limit,maximum);const result=await options.local.find({...callContext,collection:options.collection,draft,limit:pageSize,...optionalProperty("locale",options.locale),page,...optionalProperty("sort",request.query.sort?.map((sort)=>sort.direction==="desc"?`-${sort.field}`:sort.field)),...optionalProperty("where",payloadWhere(request.query.filter))});const items=result.docs.map((row)=>record(kind,options,row));if(pagination.mode==="page"){return success(request.requestId,{items,page,pageSize,pagination:"page",totalItems:result.totalDocs,totalPages:result.totalPages})}return success(request.requestId,{items,...optionalProperty("nextCursor",page>=result.totalPages?undefined:cursor(kind,page+1)),pagination:"cursor"})};const executeCreate=async(request,callContext,draft)=>{const row=await options.local.create({...callContext,collection:options.collection,data:parseJsonValue(request.value),draft,...optionalProperty("locale",options.locale)});return success(request.requestId,record(kind,options,row))};const execute=async(request,context,requestOptions)=>{const unsupported=unsupportedOperation(request.requestId,options.definition.capabilities,request.operation);if(unsupported!==undefined){return unsupported}const user=options.user(context);const callContext={overrideAccess:false,...optionalProperty("req",options.nativeRequest?.(context)),user};const draft=options.includeDrafts===true;try{if(request.operation==="list"){return await executeList(request,callContext,draft)}if(request.operation==="create"){return await executeCreate(request,callContext,draft)}const identity=decodeIdentity(kind,options.identity.fields,request.id);const id=nativeId(options,identity);const locale=localeFor(options,identity);const current=await options.local.findByID({...callContext,collection:options.collection,draft,id,...optionalProperty("locale",locale)});if(current===null){return{correlationId:request.requestId,error:{code:"not_found",message:"The Payload document was not found",retryable:false},ok:false}}if(request.operation==="get"){return success(request.requestId,record(kind,options,current))}if(!expectedRevisionMatches(kind,options,current,request.expectedRevision)){return conflict(request.requestId)}if(request.operation==="update"){const row2=await options.local.update({...callContext,collection:options.collection,data:parseJsonValue(request.value),draft,id,...optionalProperty("locale",locale)});return success(request.requestId,record(kind,options,row2))}if(request.operation==="hard_delete"){await options.plugin?.hardDelete?.({collection:options.collection,id,...optionalProperty("locale",locale),organizationId:context.organizationId,...optionalProperty("signal",requestOptions?.signal),user});return success(request.requestId,null)}if(request.operation==="restore"){const row2=await options.plugin?.restore?.({collection:options.collection,id,...optionalProperty("locale",locale),organizationId:context.organizationId,...optionalProperty("signal",requestOptions?.signal),user});if(row2===undefined){throw new TypeError("Restore is not supported")}return success(request.requestId,record(kind,options,row2))}const row=await options.local.delete({...callContext,collection:options.collection,id,...optionalProperty("locale",locale)});return success(request.requestId,record(kind,options,row))}catch(error){return error instanceof TypeError?invalid(request.requestId,error):nativeFailure(request.requestId,error)}};const changes=options.plugin?.changes===undefined?undefined:async(request,context,requestOptions)=>{try{const after=request.cursor===undefined?undefined:decodeCursor(`${kind}:changes`,request.cursor);const user=options.user(context);const page=await options.plugin?.changes?.({...optionalProperty("after",after),collection:options.collection,limit:boundedLimit(request.limit,maximum),...optionalProperty("locale",options.locale),organizationId:context.organizationId,overlapMs:options.incrementalChanges?.overlapMs??5000,...optionalProperty("signal",requestOptions?.signal),user});if(page===undefined){throw new TypeError("Changes are unavailable")}const projectedChanges=page.changes.map((change)=>change.kind==="upsert"?{kind:"upsert",record:record(kind,options,change.row)}:{deletedAt:change.deletedAt,id:opaqueIdentity(kind,options.identity.fields,change.identity),kind:"tombstone",revision:opaqueRevision(kind,change.revision)});const final=page.changes.at(-1);const nextCursor=final===undefined?undefined:cursor(`${kind}:changes`,{externalId:final.kind==="upsert"?opaqueIdentity(kind,options.identity.fields,final.row):opaqueIdentity(kind,options.identity.fields,final.identity),updatedAt:final.kind==="upsert"?options.updatedAt(final.row):final.updatedAt});return success(request.requestId,{changes:projectedChanges,...optionalProperty("nextCursor",nextCursor)})}catch(error){return invalid(request.requestId,error)}};const source={authorization:options.authorization,...optionalProperty("changes",changes),dataSource:{capabilities:options.capabilities,kind},definition:options.definition,execute};return Object.freeze(source)};var definePayloadGlobalSource=(options)=>{assertConfiguration(options);if(!options.capabilities.nativePolicy){throw new TypeError("Payload must declare nativePolicy support")}if(options.capabilities.create||options.capabilities.hardDelete||options.capabilities.incrementalChanges||options.capabilities.restore||options.capabilities.softDelete||options.capabilities.transactions){throw new TypeError("Payload globals only support read and update")}const load=async(context)=>await options.local.findGlobal({draft:options.includeDrafts===true,...optionalProperty("locale",options.locale),overrideAccess:false,...optionalProperty("req",options.nativeRequest?.(context)),slug:options.global,user:options.user(context)});const execute=async(request,context)=>{const unsupported=unsupportedOperation(request.requestId,options.definition.capabilities,request.operation);if(unsupported!==undefined){return unsupported}try{const current=await load(context);if(request.operation==="list"){return success(request.requestId,{items:[record(kind,options,current)],...request.query.pagination.mode==="page"?{page:request.query.pagination.page,pageSize:request.query.pagination.pageSize,pagination:"page",totalItems:1,totalPages:1}:{pagination:"cursor"}})}const currentRecord=record(kind,options,current);if(request.operation==="get"){if(request.id!==currentRecord.id){return{correlationId:request.requestId,error:{code:"not_found",message:"The Payload global was not found",retryable:false},ok:false}}return success(request.requestId,currentRecord)}if(request.operation!=="update"){return invalid(request.requestId,new TypeError("Unsupported Payload global operation"))}if(!expectedRevisionMatches(kind,options,current,request.expectedRevision)){return conflict(request.requestId)}const updated=await options.local.updateGlobal({data:parseJsonValue(request.value),draft:options.includeDrafts===true,...optionalProperty("locale",options.locale),overrideAccess:false,...optionalProperty("req",options.nativeRequest?.(context)),slug:options.global,user:options.user(context)});return success(request.requestId,record(kind,options,updated))}catch(error){return error instanceof TypeError?invalid(request.requestId,error):nativeFailure(request.requestId,error)}};return Object.freeze({authorization:options.authorization,dataSource:{capabilities:options.capabilities,kind},definition:options.definition,execute})};var definePayloadGatewayPlugin=(hooks)=>Object.freeze(hooks);var{definePayloadGatewayPlugin:definePayloadGatewayPlugin2,definePayloadGlobalSource:definePayloadGlobalSource2,definePayloadSource:definePayloadSource2}=exports_payload;export{definePayloadSource2 as definePayloadSource,definePayloadGlobalSource2 as definePayloadGlobalSource,definePayloadGatewayPlugin2 as definePayloadGatewayPlugin};