Class AlibabaFcAdapter

Alibaba FC Adapter for Stone.js.

The AlibabaFcAdapter provides seamless integration between Stone.js applications and the Alibaba FC environment. It processes incoming events from Alibaba FC, transforms them into IncomingEvent instances, and returns a RawResponse.

This adapter ensures compatibility with Alibaba FC's execution model and abstracts the event handling process for Stone.js developers.

Template: AlibabaFcEvent

The type of the raw event received from Alibaba FC.

Template: RawResponse

The type of the response to send back to Alibaba FC.

Template: AlibabaFcContext

The Alibaba FC execution context type.

Template: IncomingEvent

The type of the processed incoming event.

Template: IncomingEventOptions

Options used to create an incoming event.

Template: OutgoingResponse

The type of the outgoing response after processing.

Template: AlibabaFcAdapterContext

Context type specific to the adapter.

Example

import { AlibabaFcAdapter } from '@stone-js/alibaba-fc-adapter';

const adapter = AlibabaFcAdapter.create({...});

const handler = await adapter.run();

export { handler };

See

Hierarchy

Adapter<
    AlibabaFcEvent,
    RawResponse,
    AlibabaFcContext,
    IncomingEvent,
    IncomingEventOptions,
    OutgoingResponse,
    AlibabaFcAdapterContext,
>
- AlibabaFcAdapter

Constructors

`Protected`constructor

new AlibabaFcAdapter(blueprint: IBlueprint): AlibabaFcAdapter
Create an Adapter.
Parameters
- blueprint: IBlueprint
  The blueprint to create the adapter.
Returns AlibabaFcAdapter

Inherited from Adapter< AlibabaFcEvent, RawResponse, AlibabaFcContext, IncomingEvent, IncomingEventOptions, OutgoingResponse, AlibabaFcAdapterContext >.constructor

Properties

`Protected` `Readonly`blueprint

blueprint: IBlueprint

`Protected` `Readonly`hooks

hooks: AdapterHookType<AlibabaFcAdapterContext, RawResponse>

`Protected` `Readonly`middleware

middleware: AdapterMixedPipeType<AlibabaFcAdapterContext, RawResponse>[]

`Protected` `Readonly`resolvedErrorHandlers

resolvedErrorHandlers: Record<
string,
IAdapterErrorHandler<RawEventType, RawResponseType, ExecutionContextType>,
>

Methods

`Protected`buildRawResponse

buildRawResponse(
context: AlibabaFcAdapterContext,
eventHandler?: AdapterEventHandlerType<IncomingEvent, OutgoingResponse>,
): Promise<RawResponse>
Build the raw response.
Parameters
- context: AlibabaFcAdapterContext
  The event context.
- OptionaleventHandler: AdapterEventHandlerType<IncomingEvent, OutgoingResponse>
  The event handler to be run.
Returns Promise<RawResponse>
The raw response wrapper.

Inherited from Adapter.buildRawResponse

`Protected`eventListener

eventListener(
rawEvent: AlibabaFcEvent,
executionContext: AlibabaFcContext,
): Promise<RawResponse>
Processes an incoming Alibaba FC event.

This method transforms the raw Alibaba FC event into a Stone.js IncomingEvent, processes it through the pipeline, and generates a RawResponse to send back.
Parameters
- rawEvent: AlibabaFcEvent
  The raw Alibaba FC event to be processed.
- executionContext: AlibabaFcContext
  The Alibaba FC execution context for the event.
Returns Promise<RawResponse>
A promise resolving to the processed RawResponse.

`Protected`executeEventHandlerHooks

executeEventHandlerHooks(
hook: KernelHookName,
eventHandler: AdapterEventHandlerType<IncomingEvent, OutgoingResponse>,
): Promise<void>
Execute the event handler lifecycle hooks.
Parameters
- hook: KernelHookName
  The hook to execute.
- eventHandler: AdapterEventHandlerType<IncomingEvent, OutgoingResponse>
  The event handler to be run.
Returns Promise<void>

Inherited from Adapter.executeEventHandlerHooks

`Protected`executeHooks

executeHooks(
    name: AdapterHookName,
    context?: AlibabaFcAdapterContext,
    error?: any,
): Promise<void>
Execute adapter lifecycle hooks.
Parameters
- name: AdapterHookName
  The hook's name.
- Optionalcontext: AlibabaFcAdapterContext
  The event context.
- Optionalerror: any
  The error to handle.
Returns Promise<void>

Inherited from Adapter.executeHooks

`Protected`handleError

handleError(
error: Error,
context: AlibabaFcAdapterContext,
): Promise<AdapterEventBuilderType<RawResponse>>
Handle error.
Parameters
- error: Error
  The error to handle.
- context: AlibabaFcAdapterContext
  The event context.
Returns Promise<AdapterEventBuilderType<RawResponse>>
The raw response.

Inherited from Adapter.handleError

`Protected`handleEvent

handleEvent(
    context: AlibabaFcAdapterContext,
    eventHandler: AdapterEventHandlerType<IncomingEvent, OutgoingResponse>,
): Promise<
    IAdapterEventBuilder<
        RawResponseOptions,
        IRawResponseWrapper<RawResponse>,
    >,
>
Handle the event.
Parameters
- context: AlibabaFcAdapterContext
  The event context.
- eventHandler: AdapterEventHandlerType<IncomingEvent, OutgoingResponse>
  The event handler to be run.
Returns Promise<
    IAdapterEventBuilder<
        RawResponseOptions,
        IRawResponseWrapper<RawResponse>,
    >,
>
The raw response wrapper.

Inherited from Adapter.handleEvent

`Protected`makePipelineOptions

makePipelineOptions(): PipelineOptions<
AlibabaFcAdapterContext,
AdapterEventBuilderType<RawResponse>,
>

Create pipeline options for the Adapter.

Returns PipelineOptions<AlibabaFcAdapterContext, AdapterEventBuilderType<RawResponse>>
The pipeline options for transforming the event.

Inherited from Adapter.makePipelineOptions

`Protected`onStart

onStart(): Promise<void>

Initializes the adapter and validates its execution context.

Ensures the adapter is running in an Alibaba FC environment. If not, it throws an error to prevent misuse.

Returns Promise<void>

Throws
If executed outside an Alibaba FC context (e.g., browser).

`Protected`resolveErrorHandler

resolveErrorHandler(
error: Error,
): IAdapterErrorHandler<AlibabaFcEvent, RawResponse, AlibabaFcContext>
Get the error handler for the given error.
Parameters
- error: Error
  The error to get the handler for.
Returns IAdapterErrorHandler<AlibabaFcEvent, RawResponse, AlibabaFcContext>
The error handler.

Throws
IntegrationError

Inherited from Adapter.resolveErrorHandler

`Protected`resolveEventHandler

resolveEventHandler(): AdapterEventHandlerType<IncomingEvent, OutgoingResponse>

Get the event handler for the adapter.

Returns AdapterEventHandlerType<IncomingEvent, OutgoingResponse>
The event handler for the adapter.

Throws
If the event handler is missing.

Inherited from Adapter.resolveEventHandler

run

run<ExecutionResultType = AlibabaFcEventHandlerFunction>(): Promise<
ExecutionResultType,
>
Executes the adapter and provides an Alibaba FC-compatible handler function.

The run method initializes the adapter and returns a handler function that Alibaba FC can invoke. This handler processes events, manages context, and returns the appropriate response.
Type Parameters
- ExecutionResultType = AlibabaFcEventHandlerFunction
  The type representing the Alibaba FC event handler function.
Returns Promise<ExecutionResultType>
A promise resolving to the Alibaba FC handler function.

Throws
If used outside the Alibaba FC environment.

Overrides Adapter.run

`Protected`sendEventThroughDestination

sendEventThroughDestination(
context: AlibabaFcAdapterContext,
eventHandler: AdapterEventHandlerType<IncomingEvent, OutgoingResponse>,
): Promise<RawResponse>
Send the raw event through the destination.
Parameters
- context: AlibabaFcAdapterContext
  The event context.
- eventHandler: AdapterEventHandlerType<IncomingEvent, OutgoingResponse>
  The event handler to be run.
Returns Promise<RawResponse>
Platform-specific response.

Throws
IntegrationError

Inherited from Adapter.sendEventThroughDestination

`Protected`validateContextAndEventHandler

validateContextAndEventHandler(
context: AlibabaFcAdapterContext,
eventHandler: AdapterEventHandlerType<IncomingEvent, OutgoingResponse>,
): void
Validate the context and event handler.
Parameters
- context: AlibabaFcAdapterContext
  The context to validate.
- eventHandler: AdapterEventHandlerType<IncomingEvent, OutgoingResponse>
  The event handler to validate.
Returns void

Throws
IntegrationError

Inherited from Adapter.validateContextAndEventHandler

`Static`create

create(blueprint: IBlueprint): AlibabaFcAdapter
Creates an instance of the AlibabaFcAdapter.
Parameters
- blueprint: IBlueprint
  The application blueprint.
Returns AlibabaFcAdapter
A new instance of AlibabaFcAdapter.
Example
```
const adapter = AlibabaFcAdapter.create(blueprint);
await adapter.run();
```

Class AlibabaFcAdapter

Template: AlibabaFcEvent

Template: RawResponse

Template: AlibabaFcContext

Template: IncomingEvent

Template: IncomingEventOptions

Template: OutgoingResponse

Template: AlibabaFcAdapterContext

Example

See

Hierarchy

Index

Constructors

Properties

Methods

Constructors

Protectedconstructor

Parameters

Returns AlibabaFcAdapter

Properties

Protected Readonlyblueprint

Protected Readonlyhooks

Protected Readonlymiddleware

Protected ReadonlyresolvedErrorHandlers

Methods

ProtectedbuildRawResponse

Parameters

Returns Promise<RawResponse>

ProtectedeventListener

Parameters

Returns Promise<RawResponse>

ProtectedexecuteEventHandlerHooks

Parameters

Returns Promise<void>

ProtectedexecuteHooks

Parameters

Returns Promise<void>

ProtectedhandleError

Parameters

Returns Promise<AdapterEventBuilderType<RawResponse>>

ProtectedhandleEvent

Parameters

Returns Promise< IAdapterEventBuilder< RawResponseOptions, IRawResponseWrapper<RawResponse>, >,>

ProtectedmakePipelineOptions

Returns PipelineOptions<AlibabaFcAdapterContext, AdapterEventBuilderType<RawResponse>>

ProtectedonStart

Returns Promise<void>

Throws

ProtectedresolveErrorHandler

Parameters

Returns IAdapterErrorHandler<AlibabaFcEvent, RawResponse, AlibabaFcContext>

Throws

ProtectedresolveEventHandler

Returns AdapterEventHandlerType<IncomingEvent, OutgoingResponse>

Throws

run

Type Parameters

Returns Promise<ExecutionResultType>

Throws

ProtectedsendEventThroughDestination

Parameters

Returns Promise<RawResponse>

Throws

ProtectedvalidateContextAndEventHandler

Parameters

Returns void

Throws

Staticcreate

Parameters

Returns AlibabaFcAdapter

Example

Settings

On This Page

`Protected`constructor

`Protected` `Readonly`blueprint

`Protected` `Readonly`hooks

`Protected` `Readonly`middleware

`Protected` `Readonly`resolvedErrorHandlers

`Protected`buildRawResponse

`Protected`eventListener

`Protected`executeEventHandlerHooks

`Protected`executeHooks

`Protected`handleError

`Protected`handleEvent

Returns Promise<
IAdapterEventBuilder<
RawResponseOptions,
IRawResponseWrapper<RawResponse>,
>,
>

`Protected`makePipelineOptions

`Protected`onStart

`Protected`resolveErrorHandler

`Protected`resolveEventHandler

`Protected`sendEventThroughDestination

`Protected`validateContextAndEventHandler

`Static`create