Skip to content
Emdash Mika Docs

Package Exports

Use this when choosing imports. Import package subpaths for contracts and factories; copy files only from @bnomei/emdash-mika/templates/astro/*.

Subpath Use this when… Do not use this for…
@bnomei/emdash-mika Registering the native EmDash plugin with mikaPlugin({ api }). Browser code or copied page UI.
@bnomei/emdash-mika/acp Projecting Mika catalog and checkout semantics into host-owned ACP endpoints. Claiming Mika ships a hosted ACP server.
@bnomei/emdash-mika/agent Building public agent manifests or host-owned protocol projections from operation descriptors. Publishing protected tools without host auth/policy.
@bnomei/emdash-mika/admin Creating EmDash action provider config and field button options. Public storefront mutations.
@bnomei/emdash-mika/astro Astro pages/endpoints that need createMika(Astro), formatting, redirect, hidden-input, or purchase helpers. Long-lived browser clients.
@bnomei/emdash-mika/astro-actions src/actions/mika.ts and action registration. Direct route handlers or plugin JSON routes.
@bnomei/emdash-mika/client Public catalog or stock JSON reads from framework islands. Protected cart, checkout, account, webhook, admin, or agent-tool mutations.
@bnomei/emdash-mika/email Built-in email renderer helpers. Email transport, queues, credentials, or deliverability policy.
@bnomei/emdash-mika/provider Provider registry and provider-neutral contracts. A real payment/tax/shipping provider implementation by itself.
@bnomei/emdash-mika/react Optional React bindings exported by the package. Astro page routing or provider SDK wiring.
@bnomei/emdash-mika/server Trusted backend API composition and overrides. Browser bundles.
@bnomei/emdash-mika/stripe Optional Stripe provider adapter wiring in server-only host modules. Making Stripe mandatory or exposing Stripe SDK clients publicly.
@bnomei/emdash-mika/types DTOs, branded primitives, provider capabilities, and public input/result types. Internal storage repository imports.
@bnomei/emdash-mika/templates/astro/* Copying host-owned Astro template files into an app. Runtime imports for hidden package-owned pages.

Do not import internal src/api or src/storage modules as public API.

See Client and React for the browser-safe read boundary.

Root Export Details

Section titled “Root Export Details”

The root @bnomei/emdash-mika export is for EmDash plugin registration and runtime activation:

  • mikaPlugin() builds the static EmDash plugin descriptor for astro.config.mjs;
  • createPlugin() is the native runtime entrypoint EmDash activates;
  • mika is an alias for mikaPlugin;
  • MIKA_PLUGIN_ID, MIKA_PLUGIN_VERSION, and MIKA_PACKAGE_NAME identify the plugin and default package entrypoint;
  • MIKA_MAINTENANCE_CRON_TASK and MIKA_MAINTENANCE_CRON_SCHEDULE identify the built-in maintenance task;
  • MikaDescriptorOptions, MikaCreatePluginOptions, and MikaMaintenancePluginOptions type descriptor/runtime options;
  • MikaOperationDescriptor and MikaOperationPolicy type operation metadata and host policy hooks.

Runtime And Peer Ranges

Section titled “Runtime And Peer Ranges”
  • Node engine: >=22.12.0.
  • Astro peer range: ^6.0.0 || ^7.0.0.
  • EmDash peer range: >=0.22.0 <1.0.0.
  • Optional peer packages: @cloudflare/kumo, @phosphor-icons/react, react, react-dom, and stripe.
  • Published package files are dist plus src/templates; copyable templates are exposed by ./templates/astro/*.

Source Anchors

Section titled “Source Anchors”
  • ⓟ ../emdash-mika/package.json
  • ⓟ ../emdash-mika/src/index.ts
  • ⓟ ../emdash-mika/src/plugin.ts
  • ⓟ ../emdash-mika/test/package-exports.ts