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

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

@@ -0,0 +1,389 @@
+// 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 StrapiParameters = Readonly<Record<string, ResourceJsonValue>>;
+export interface StrapiDocumentService {
+	readonly count: (parameters: StrapiParameters) => Promise<number>;
+	readonly create: (parameters: StrapiParameters) => Promise<NativeRecord>;
+	readonly delete: (parameters: StrapiParameters) => Promise<NativeRecord>;
+	readonly findFirst: (parameters: StrapiParameters) => Promise<NativeRecord | null>;
+	readonly findMany: (parameters: StrapiParameters) => Promise<readonly NativeRecord[]>;
+	readonly findOne: (parameters: StrapiParameters) => Promise<NativeRecord | null>;
+	readonly publish?: (parameters: StrapiParameters) => Promise<NativeRecord>;
+	readonly unpublish?: (parameters: StrapiParameters) => Promise<NativeRecord>;
+	readonly update: (parameters: StrapiParameters) => Promise<NativeRecord>;
+}
+export interface StrapiDocumentServiceFactory {
+	readonly documents: (uid: string) => StrapiDocumentService;
+}
+export type StrapiGatewayHooks = Readonly<{
+	changes?: (input: {
+		after?: Readonly<{
+			externalId: string;
+			updatedAt: string;
+		}>;
+		limit: number;
+		locale?: string;
+		organizationId: string;
+		overlapMs: number;
+		signal?: AbortSignal;
+		uid: string;
+	}) => Promise<NativeChangePage>;
+	restore?: (input: {
+		documentId: string;
+		locale?: string;
+		organizationId: string;
+		signal?: AbortSignal;
+		uid: string;
+	}) => Promise<NativeRecord>;
+	softDelete?: (input: {
+		documentId: string;
+		locale?: string;
+		organizationId: string;
+		signal?: AbortSignal;
+		uid: string;
+	}) => Promise<NativeRecord>;
+}>;
+export type StrapiNativeAction = "create" | "delete" | "find" | "publish" | "restore" | "update";
+export type StrapiSourceOptions<Entity = NativeRecord> = DataSourceBaseOptions<Entity> & Readonly<{
+	authorize: (input: {
+		action: StrapiNativeAction;
+		context: Parameters<DataSourceAdapter["execute"]>[1];
+	}) => Promise<void> | void;
+	contentType: "collection" | "single";
+	documents: StrapiDocumentServiceFactory;
+	includeDrafts?: boolean;
+	incrementalChanges?: Readonly<{
+		overlapMs?: number;
+	}>;
+	locale?: string;
+	localeField?: string;
+	plugin?: StrapiGatewayHooks;
+	sanitize: (input: {
+		action: StrapiNativeAction;
+		context: Parameters<DataSourceAdapter["execute"]>[1];
+		value: NativeRecord;
+	}) => Promise<NativeRecord> | NativeRecord;
+	uid: string;
+}>;
+export type StrapiDataSource<Entity = NativeRecord> = DataSourceAdapter<Entity> & Readonly<{
+	publication: Readonly<{
+		publish?: (input: Readonly<{
+			context: Parameters<DataSourceAdapter["execute"]>[1];
+			documentId: string;
+			locale?: string;
+		}>) => Promise<Entity>;
+		unpublish?: (input: Readonly<{
+			context: Parameters<DataSourceAdapter["execute"]>[1];
+			documentId: string;
+			locale?: string;
+		}>) => Promise<Entity>;
+	}>;
+}>;
+export declare const defineStrapiGatewayPlugin: (hooks: StrapiGatewayHooks) => StrapiGatewayHooks, defineStrapiSource: <Entity = Readonly<Record<string, ResourceJsonValue>>>(options: StrapiSourceOptions<Entity>) => StrapiDataSource<Entity>;
+
+export {};

package/dist/knowledge-sources/strapi.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_strapi={};__export(exports_strapi,{defineStrapiSource:()=>defineStrapiSource,defineStrapiGatewayPlugin:()=>defineStrapiGatewayPlugin});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 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 nativeFilter=(filter)=>{if("filters"in filter){return{...filter,filters:filter.filters.map(nativeFilter)}}if("filter"in filter){return{...filter,filter:nativeFilter(filter.filter)}}return{...filter,operator:nativeFilterOperator(filter.operator)}};var kind="strapi";var optionalProperty=(key,value)=>value===undefined?{}:{[key]:value};var documentId=(identity)=>{const value=identity.documentId;const documentIdentifier=optionalNativeString(value);if(documentIdentifier===undefined||documentIdentifier.length===0){throw new TypeError("Strapi identity must contain documentId")}return documentIdentifier};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 validateStrapi=(options)=>{if(options.identity.fields[0]!=="documentId"){throw new TypeError("Strapi identity must prefer documentId")}if(!options.capabilities.nativePolicy){throw new TypeError("Strapi must declare nativePolicy support")}if(options.capabilities.transactions||options.capabilities.softDelete!==(options.softDelete!==undefined)){throw new TypeError("Strapi transaction and soft-delete capabilities require explicit policy")}if(options.capabilities.softDelete!==(options.plugin?.softDelete!==undefined)||options.capabilities.restore!==(options.plugin?.restore!==undefined)||options.capabilities.incrementalChanges!==(options.plugin?.changes!==undefined)){throw new TypeError("Strapi capabilities must match installed plugin hooks")}};var defineStrapiSource=(options)=>{assertConfiguration(options);validateStrapi(options);const maximum=options.maxPageSize??100;const documents=options.documents.documents(options.uid);const published=options.includeDrafts===true?"draft":"published";const sanitizedRecord=async(action,context,row)=>record(kind,options,await options.sanitize({action,context,value:row}));const paginationStart=(pagination)=>{if(pagination.mode==="cursor"){return pagination.cursor===undefined?0:decodeCursor(kind,pagination.cursor)}return(pagination.page-1)*pagination.pageSize};const executeList=async(request,context,publishedStatus)=>{await options.authorize({action:"find",context});const{pagination}=request.query;const limit=boundedLimit(pagination.mode==="cursor"?pagination.limit:pagination.pageSize,maximum);const start=paginationStart(pagination);const parameters={...optionalProperty("filters",request.query.filter===undefined?undefined:nativeFilter(request.query.filter)),limit,...optionalProperty("locale",options.locale),start,status:publishedStatus,...optionalProperty("sort",request.query.sort?.map(({direction,field})=>`${field}:${direction}`))};let rows;if(options.contentType==="single"){const single=await documents.findFirst(parameters);rows=single===null?[]:[single]}else{rows=await documents.findMany(parameters)}const items=await Promise.all(rows.map(async(row)=>await sanitizedRecord("find",context,row)));if(pagination.mode==="page"){const totalItems=options.contentType==="single"?items.length:await documents.count(parameters);return success(request.requestId,{items,page:pagination.page,pageSize:pagination.pageSize,pagination:"page",totalItems,totalPages:Math.ceil(totalItems/pagination.pageSize)})}return success(request.requestId,{items,...optionalProperty("nextCursor",items.length<limit?undefined:cursor(kind,start+items.length)),pagination:"cursor"})};const lifecycleMethod=(operation)=>operation==="restore"?options.plugin?.restore:options.plugin?.softDelete;const execute=async(request,context,requestOptions)=>{const unsupported=unsupportedOperation(request.requestId,options.definition.capabilities,request.operation);if(unsupported!==undefined){return unsupported}try{if(request.operation==="list"){return await executeList(request,context,published)}if(request.operation==="create"){await options.authorize({action:"create",context});const row2=await documents.create({data:parseJsonValue(request.value),...optionalProperty("locale",options.locale),status:published});return success(request.requestId,await sanitizedRecord("create",context,row2))}const identity=decodeIdentity(kind,options.identity.fields,request.id);const id=documentId(identity);const locale=localeFor(options,identity);await options.authorize({action:"find",context});const current=await documents.findOne({documentId:id,...optionalProperty("locale",locale),status:published});if(current===null){return{correlationId:request.requestId,error:{code:"not_found",message:"The Strapi document was not found",retryable:false},ok:false}}if(request.operation==="get"){return success(request.requestId,await sanitizedRecord("find",context,current))}if(!expectedRevisionMatches(kind,options,current,request.expectedRevision)){return conflict(request.requestId)}if(request.operation==="update"){await options.authorize({action:"update",context});const row2=await documents.update({data:parseJsonValue(request.value),documentId:id,...optionalProperty("locale",locale),status:published});return success(request.requestId,await sanitizedRecord("update",context,row2))}if(request.operation==="hard_delete"){await options.authorize({action:"delete",context});await documents.delete({documentId:id,...optionalProperty("locale",locale)});return success(request.requestId,null)}const action=request.operation==="restore"?"restore":"delete";await options.authorize({action,context});const method=lifecycleMethod(request.operation==="restore"?"restore":"soft_delete");const row=await method?.({documentId:id,...optionalProperty("locale",locale),organizationId:context.organizationId,...optionalProperty("signal",requestOptions?.signal),uid:options.uid});if(row===undefined){throw new TypeError(`${request.operation} is not supported`)}return success(request.requestId,await sanitizedRecord(action,context,row))}catch(error){return error instanceof TypeError?invalid(request.requestId,error):nativeFailure(request.requestId,error)}};const publication=(action)=>{const method=documents[action];return method===undefined?undefined:async(input)=>{await options.authorize({action:"publish",context:input.context});const row=await method({documentId:input.documentId,...optionalProperty("locale",input.locale)});const sanitized=await sanitizedRecord("publish",input.context,row);return sanitized.value}};const changes=options.plugin?.changes===undefined?undefined:async(request,context,requestOptions)=>{try{await options.authorize({action:"find",context});const after=request.cursor===undefined?undefined:decodeCursor(`${kind}:changes`,request.cursor);const page=await options.plugin?.changes?.({...optionalProperty("after",after),limit:boundedLimit(request.limit,maximum),...optionalProperty("locale",options.locale),organizationId:context.organizationId,overlapMs:options.incrementalChanges?.overlapMs??5000,...optionalProperty("signal",requestOptions?.signal),uid:options.uid});if(page===undefined){throw new TypeError("Changes are unavailable")}const projectedChanges=await Promise.all(page.changes.map(async(change)=>change.kind==="upsert"?{kind:"upsert",record:await sanitizedRecord("find",context,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 publish=publication("publish");const unpublish=publication("unpublish");const source={authorization:options.authorization,...optionalProperty("changes",changes),dataSource:{capabilities:options.capabilities,kind},definition:options.definition,execute,publication:{...optionalProperty("publish",publish),...optionalProperty("unpublish",unpublish)}};return Object.freeze(source)};var defineStrapiGatewayPlugin=(hooks)=>Object.freeze(hooks);var{defineStrapiGatewayPlugin:defineStrapiGatewayPlugin2,defineStrapiSource:defineStrapiSource2}=exports_strapi;export{defineStrapiSource2 as defineStrapiSource,defineStrapiGatewayPlugin2 as defineStrapiGatewayPlugin};

package/dist/persistence/drizzle-effect.d.ts

@@ -0,0 +1,38 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import * as Context from 'effect/Context';
+import * as Layer from 'effect/Layer';
+import * as Schema from 'effect/Schema';
+import { Pool, PoolConfig } from 'pg';
+
+declare const DrizzlePostgresInitializationError_base: Schema.Class<DrizzlePostgresInitializationError, Schema.TaggedStruct<"DrizzlePostgresInitializationError", {
+	readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+declare class DrizzlePostgresInitializationError extends DrizzlePostgresInitializationError_base {
+}
+declare const makeDatabase: (pool: Pool) => import("drizzle-orm/node-postgres").NodePgDatabase<import("drizzle-orm").EmptyRelations> & {
+	$client: Pool;
+};
+export type DrizzlePostgresValue = Readonly<{
+	database: ReturnType<typeof makeDatabase>;
+	pool: Pool;
+}>;
+declare const DrizzlePostgres_base: Context.ServiceClass<DrizzlePostgres, "@collective-intelligence/external-apps-server-sdk/DrizzlePostgres", Readonly<{
+	database: ReturnType<typeof makeDatabase>;
+	pool: Pool;
+}>>;
+declare class DrizzlePostgres extends DrizzlePostgres_base {
+}
+export type NodePostgresLayerOptions = Readonly<{
+	connection: PoolConfig;
+	/** Explicit host-selected migration hook. The SDK never discovers or runs DDL implicitly. */
+	migrate?: (value: DrizzlePostgresValue) => Promise<void>;
+}>;
+declare const DrizzlePostgres$1: typeof DrizzlePostgres, DrizzlePostgresInitializationError$1: typeof DrizzlePostgresInitializationError, layerFromDatabase: (value: DrizzlePostgresValue) => import("effect/Layer").Layer<DrizzlePostgres, never, never>, layerNodePostgres: (options: NodePostgresLayerOptions) => import("effect/Layer").Layer<DrizzlePostgres, DrizzlePostgresInitializationError, never>;
+
+export {
+	DrizzlePostgres$1 as DrizzlePostgres,
+	DrizzlePostgresInitializationError$1 as DrizzlePostgresInitializationError,
+};
+
+export {};

package/dist/persistence/drizzle-effect.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_drizzle_effect={};__export(exports_drizzle_effect,{layerNodePostgres:()=>layerNodePostgres,layerFromDatabase:()=>layerFromDatabase,DrizzlePostgresInitializationError:()=>DrizzlePostgresInitializationError,DrizzlePostgres:()=>DrizzlePostgres});import{drizzle}from"drizzle-orm/node-postgres";import*as Context from"effect/Context";import*as Effect from"effect/Effect";import*as Layer from"effect/Layer";import{Pool}from"pg";import*as Schema from"effect/Schema";class DrizzlePostgresInitializationError extends Schema.TaggedError()("DrizzlePostgresInitializationError",{cause:Schema.Defect()}){}var makeDatabase=(pool)=>drizzle({client:pool});class DrizzlePostgres extends Context.Service()("@collective-intelligence/external-apps-server-sdk/DrizzlePostgres"){}var layerFromDatabase=(value)=>Layer.succeed(DrizzlePostgres,value);var layerNodePostgres=(options)=>Layer.effect(DrizzlePostgres,Effect.acquireRelease(Effect.sync(()=>new Pool(options.connection)),(pool)=>Effect.promise(async()=>{await pool.end()})).pipe(Effect.flatMap((pool)=>{const value=DrizzlePostgres.of({database:makeDatabase(pool),pool});const{migrate}=options;return migrate===undefined?Effect.succeed(value):Effect.tryPromise({catch:(cause)=>new DrizzlePostgresInitializationError({cause}),try:migrate.bind(undefined,value)}).pipe(Effect.as(value))})));var{DrizzlePostgres:DrizzlePostgres2,DrizzlePostgresInitializationError:DrizzlePostgresInitializationError2,layerFromDatabase:layerFromDatabase2,layerNodePostgres:layerNodePostgres2}=exports_drizzle_effect;export{layerNodePostgres2 as layerNodePostgres,layerFromDatabase2 as layerFromDatabase,DrizzlePostgresInitializationError2 as DrizzlePostgresInitializationError,DrizzlePostgres2 as DrizzlePostgres};