Command Line Interface (CLI)

src/
  index.ts                # the events map — your default export
  functions/              # one file per handler
    order-created.ts
    customer-login.ts
test/
  index.spec.ts           # example tests for the handlers
dist/
  index.js                # build output (generated; this is what gets deployed)
.env.example              # template for CLI config — copy to .env

import type { DefineEvents } from "@salla.sa/app-functions-types";
import { orderCreated } from "./functions/order-created";
import { customerLogin } from "./functions/customer-login";

// The types package ships no runtime code, so provide the identity
// implementation and borrow its `DefineEvents` signature for key validation.
const defineEvents: DefineEvents = (events) => events;

const events = defineEvents({
  "order.created": orderCreated,
  "customer.login": customerLogin,
});

export default events;

import type { FunctionResponse, Order } from "@salla.sa/app-functions-types";

export const orderCreated = (context: Order): FunctionResponse => {
  const order = context.payload.data;

  console.log(`New order #${order.id} received!`);

  return {
    success: true,
    status: 200,
    message: `Order ${order.reference_id} received`,
    data: { orderId: order.id },
  };
};

? Select the app you want to deploy to
❯ My Awesome App [1234567890] (public)
  Shipping Companion [9876543210] (shipping)

✔ Hooray! Built /your-project/dist/index.js successfully.
ℹ You can now deploy your app using: salla app functions deploy 1234567890

2026-07-23 14:05:12 |  INFO | New order #560915 received!
2026-07-23 14:05:12 | ERROR | Failed to notify the shipping provider

const events = defineEvents({
  "custom.event.nightly-inventory-sync": nightlyInventorySync,
});

https://api.salla.dev/platform/general/<app_id>/local

import type { FunctionResponse, SallaCustomEvent } from "@salla.sa/app-functions-types";

export const nightlyInventorySync = (context: SallaCustomEvent): FunctionResponse => {
  const { sku, quantity, source } = context.payload.data;

  console.log(`Syncing ${quantity} × ${sku} from ${source}`);

  return {
    success: true,
    status: 200,
    message: "Inventory synced",
    data: { sku, quantity },
  };
};

X-App-Function-Authorization: Bearer <your-token-is-filled-in-here>

{
  token: "Bearer <token>",
  scheme: "Bearer"
}

{
  token: null,
  scheme: null
}

export default async function (context) {
  if (!context.authorization.token) {
    return { status: 401, body: "Unauthorized" };
  }

  const response = await fetch("https://api.example.com/inventory/status", {
    method: "GET",
    headers: {
      "Authorization": context.authorization.token,
      "Content-Type": "application/json",
    },
  });

  const data = await response.json();

  // ...continue processing the event with `data`
  return { success: true, status: 200, body: data };
}