Platform mode

mode: "platform" is the default and needs no server. Your bundle is served from aip.times.et inside a sandboxed iframe. All data access goes through the bridge, which forwards calls to the TIMES API with the merchant session and checks your granted scopes.

Persistent stateCopy Anchor Link

Each install gets a key-value store scoped to the workspace and your slug.

const prefs = await client.api.getState<{ days: number }>('prefs');
await client.api.putState('prefs', { days: 7 }, prefs.revision);

Pass the last revision to avoid overwriting a newer write. A stale revision fails with a conflict.

LimitsCopy Anchor Link

Need background jobs or third-party secrets? Use runtime mode.