| Mika |
The @bnomei/emdash-mika package: commerce primitives, operation descriptors, Astro helpers, Astro Actions, provider contracts, admin-action metadata, ACP helpers, and copyable Astro templates. |
| Host app |
The Astro + EmDash project that installs Mika, owns routes/content/policy/secrets/storage, and copies template files. |
| EmDash plugin descriptor |
The serializable plugin object returned by mikaPlugin(...) for astro.config.mjs. |
| Native entrypoint |
A host module such as src/plugins/mika-plugin.ts that exports createPlugin() so runtime-only function values can be wired outside serializable descriptor options. |
MikaApi |
The namespaced backend contract consumed by pages, Actions, plugin routes, admin runners, ACP helpers, and server clients. |
MikaApiResult |
The standard result envelope: success carries { ok: true, status, data }; failure carries { ok: false, status, error }. |
createMika(Astro) |
Request-bound Astro helper for server page/endpoint code. It resolves the current request, session, URL, and host API before calling Mika operations. |
| Astro Action |
A server action exported from src/actions/index.ts; Mika’s copied forms submit to actions.mika.*. |
| Sellable |
A purchasable unit (SellableDTO) attached to host content, with active state, prices, variants, and optional availability. |
| Content ref |
A stable product/content pointer with collection, id, and optional locale; route slugs are host-owned and do not have to equal content IDs. |
| Price |
A PriceDTO on a sellable: amount in minor units, currency, purchase mode, fulfillment kind, interval fields, provider refs, and active state. |
| Route key |
A stable descriptor key such as catalogSellables; Mika maps it to an EmDash plugin route path. |
| Plugin JSON route |
A route under /_emdash/api/plugins/mika/.... Only catalog.sellables and stock.availability are public reads by default. |
| Copied Astro page |
A template page copied from @bnomei/emdash-mika/templates/astro/* into src/pages/; after copy, it is host-owned code. |
| Admin action |
A trusted EmDash action provider operation, described by @bnomei/emdash-mika/admin and executed by Mika’s runner route. |
| Operation descriptor |
Source metadata in src/api/operations.ts for name, schema, route, Action, visibility, policy, and agent projection. |
| Operation policy |
Host-supplied authorization logic that can run at the operation layer across plugin routes or trusted runner projections. |
| Guard |
Host-supplied Astro Action check that runs before a browser action dispatches to Mika. |
| Provider adapter |
A server-only adapter implementing Mika’s provider contract for checkout, portal, refunds, sync, invoices, subscriptions, and webhooks. |
| Stripe adapter |
Optional provider adapter from @bnomei/emdash-mika/stripe; the host still owns the Stripe SDK client, secrets, webhook setup, retries, tax, shipping, and compliance. |
| ACP projection |
Host-owned ACP endpoints that use Mika ACP helpers for feeds and checkout session handlers. Mika does not mount an ACP server by itself. |
| Public projection |
Read-only metadata or descriptor output that is safe to expose without account auth, such as public manifest entries. |
| Trusted projection |
A host-owned protected tool/API surface around Mika semantics, requiring auth, confirmation, idempotency, and provider verification. |
| Hidden operation |
Service/internal operation such as webhook ingestion; not a public browser or agent route. |
| Idempotency key |
A caller/store key used to safely replay or reject duplicate protected operations. Mika reads it from contexts such as headers, request context, or runner payloads depending on the surface. |