Installation stores

import { ... } from '@storeware/plugin-sdk';

A store's record from a fresh token response, keeping secrets it already held.

function installationFrom(tokens: StorewareTokens, previous: StoredInstallation | null, now?: number): StoredInstallation

In memory, for tests and for trying things out. Gone when the process ends.

function memoryInstallationStore(): InstallationStore & { all(): StoredInstallation[]; }

One key per shop in a key-value store, such as Cloudflare KV.

function kvInstallationStore(kv: KeyValue, prefix?: string): InstallationStore

Name	Type	Description
`storeId`	`string`
`installationId`	`string`
`accessToken`	`string`
`refreshToken`	`string`
`accessTokenExpiresAt`	`number`	Milliseconds since the epoch.
`scopes`	`string[]`
`webhookSecret`	`string`
`sessionSecret`	`string`
`installedAt`	`string`
`uninstalledAt?`	`string`	Set when `app.uninstalled.v1` arrives. The secrets stay for later privacy requests.
`lastGrant?`	`string`	The install grant last traded, so a redelivered `app.installed.v1` is not traded twice.

Name	Type	Description
`get`	`(storeId: string) => Promise<StoredInstallation \| null>`
`save`	`(installation: StoredInstallation) => Promise<void>`
`delete`	`(storeId: string) => Promise<void>`

The part of a key-value store this needs. Cloudflare KV fits as it is.

Name	Type	Description
`get`	`(key: string) => Promise<string \| null>`
`put`	`(key: string, value: string) => Promise<void>`
`delete`	`(key: string) => Promise<void>`