@ekanos/sdk 0.1.2 → 0.1.3

package/api-report.md

@@ -0,0 +1,202 @@
+# `@ekanos/sdk` API report
+
+Generated — do not edit by hand.
+
+Regenerate: `pnpm --filter @ekanos/sdk api-report`
+Drift check: `pnpm --filter @ekanos/sdk api-report:check`
+
+This is the complete surface of every entrypoint. The authoring guide
+for these symbols is README.md. Entrypoints marked WORKSPACE-ONLY are
+not reachable from a published install — see the note in each section.
+
+Total exported names: **146** across 7 entrypoints.
+
+## `@ekanos/sdk` (32 exports)
+
+| Export | Kind |
+| --- | --- |
+| `AccountProductData` | interface |
+| `AccountProductDataType` | type alias |
+| `ActivationFormProps` | type alias |
+| `ActivationResult` | interface |
+| `HealthCheckResult` | interface |
+| `HealthStatus` | type alias |
+| `IntegrationActor` | type alias |
+| `IntegrationCapability` | interface |
+| `IntegrationComponentProps` | type alias |
+| `IntegrationConfig` | interface |
+| `IntegrationContext` | interface |
+| `IntegrationFetch` | type alias |
+| `IntegrationLogger` | interface |
+| `IntegrationMetadata` | interface |
+| `IntegrationPermission` | interface |
+| `IntegrationSecrets` | interface |
+| `IntegrationStorage` | interface |
+| `MarketplaceTileProps` | type alias |
+| `ScopedStore` | interface |
+| `StorageEntry` | interface |
+| `StorageKeyDeclaration` | interface |
+| `StorageKeyDeclarationInput` | type alias |
+| `StorageKeySchema` | type alias |
+| `StorageSchemaMap` | type alias |
+| `StorageSchemas` | interface |
+| `StorageScopeSchemas` | type alias |
+| `StorageWriteOptions` | interface |
+| `WidgetAskContext` | interface |
+| `WidgetConfig` | interface |
+| `WidgetSnapshot` | type alias |
+| `WidgetSuggestedPrompt` | interface |
+| `WorkspaceTargetDefinition` | interface |
+
+## `@ekanos/sdk/components` (24 exports)
+
+| Export | Kind |
+| --- | --- |
+| `ActivationDialog` | function |
+| `ActivationInline` | function |
+| `AiPromptChip` | function |
+| `AskIcon` | function |
+| `BaseActivationDialog` | function |
+| `BaseActivationForm` | function |
+| `BaseActivationFormProps` | interface |
+| `BaseMarketplaceTile` | function |
+| `BaseMarketplaceTileProps` | type alias |
+| `OAuthActivationForm` | function |
+| `OAuthActivationFormConfig` | interface |
+| `Widget` | variable |
+| `WidgetActions` | interface |
+| `WidgetAskBar` | function |
+| `WidgetContext` | variable |
+| `WidgetContextValue` | interface |
+| `WidgetDataLoading` | function |
+| `WidgetHealth` | interface |
+| `WidgetMeta` | interface |
+| `WidgetPreviewProvider` | function |
+| `WidgetPreviewProviderProps` | interface |
+| `WidgetRenderState` | type alias |
+| `WidgetState` | interface |
+| `currentReturnPath` | function |
+
+## `@ekanos/sdk/hooks` (28 exports)
+
+| Export | Kind |
+| --- | --- |
+| `ActivateIntegrationAction` | type alias |
+| `ActivateIntegrationInput` | interface |
+| `AskAssistantProvider` | function |
+| `ConnectionCheckAction` | type alias |
+| `ConnectionCheckResult` | interface |
+| `DeactivateIntegrationAction` | type alias |
+| `DeactivateIntegrationInput` | interface |
+| `FetchIntegrationStorageOptions` | interface |
+| `IntegrationActionResult` | type alias |
+| `IntegrationActivationActions` | interface |
+| `IntegrationActivationProvider` | function |
+| `OAuthErrorParam` | interface |
+| `PublishEventInput` | interface |
+| `UseOAuthConnectionStatusOptions` | interface |
+| `WidgetEvent` | interface |
+| `WidgetEventFilter` | interface |
+| `WidgetEventProvider` | function |
+| `WidgetEventSubscriber` | type alias |
+| `fetchIntegrationStorage` | function |
+| `integrationStorageUrl` | function |
+| `useActivateIntegration` | function |
+| `useAskAssistant` | function |
+| `useDeactivateIntegration` | function |
+| `useOAuthConnectionStatus` | function |
+| `useOAuthWidgetGate` | function |
+| `useRegisterAskAssistant` | function |
+| `useWidgetEventBus` | function |
+| `useWidgetEvents` | function |
+
+## `@ekanos/sdk/mcp` (13 exports) — WORKSPACE-ONLY, NOT PUBLISHED
+
+> **Not part of the partner surface.** This entrypoint is absent from
+> `publishConfig.exports` and its files are excluded from the tarball,
+> so importing `@ekanos/sdk/mcp` cannot resolve from an installed
+> package. `ToolContext` here carries the host request context,
+> including an admin Supabase client that BYPASSES RLS — it is host
+> machinery, not an authoring contract. Partner tools are declared as
+> `PartnerToolModule` from `@ekanos/sdk/integration`, whose `run`
+> receives only the capability `IntegrationContext`.
+
+| Export | Kind |
+| --- | --- |
+| `PartnerToolRun` | type alias |
+| `RenderInstruction` | type alias |
+| `ToolContext` | type alias |
+| `ToolModule` | type alias |
+| `ToolOwnershipError` | class |
+| `ToolParamsSchema` | type alias |
+| `ToolRunResult` | type alias |
+| `UiComponentMeta` | type alias |
+| `assertResourceOwnership` | function |
+| `ensureAccountMembership` | function |
+| `ensureGroupMembership` | function |
+| `getAccountId` | function |
+| `resolveSelfOnly` | function |
+
+## `@ekanos/sdk/context` (11 exports)
+
+| Export | Kind |
+| --- | --- |
+| `EgressDeniedError` | class |
+| `IntegrationContextCarrier` | interface |
+| `SecretAccessError` | class |
+| `StorageValidationError` | class |
+| `assertStorageKeyDeclared` | function |
+| `assertStorageKeyWritable` | function |
+| `isEgressAllowed` | function |
+| `isStorageKeyClientReadable` | function |
+| `parseStorageValue` | function |
+| `requireContext` | function |
+| `resolveStorageKeyDeclaration` | function |
+
+## `@ekanos/sdk/testing` (13 exports)
+
+| Export | Kind |
+| --- | --- |
+| `DefinitionContextOptions` | type alias |
+| `InvokeScheduleOptions` | interface |
+| `InvokeWebhookOptions` | interface |
+| `MockContextOptions` | interface |
+| `MockFetchHandler` | interface |
+| `MockIntegrationContext` | interface |
+| `RecordedFetchCall` | interface |
+| `RecordedLog` | interface |
+| `ScheduleInvocationOutcome` | interface |
+| `WebhookInvocationOutcome` | interface |
+| `createMockContext` | function |
+| `invokeSchedule` | function |
+| `invokeWebhook` | function |
+
+## `@ekanos/sdk/integration` (25 exports)
+
+| Export | Kind |
+| --- | --- |
+| `DefinitionCollisionInput` | interface |
+| `FirstPartyInventory` | interface |
+| `IntegrationCapabilityDeclaration` | type alias |
+| `IntegrationComponentDeclarations` | interface |
+| `IntegrationDefinition` | interface |
+| `IntegrationDefinitionSchema` | variable |
+| `IntegrationPermissionDeclaration` | type alias |
+| `IntegrationProposals` | type alias |
+| `OAuthProviderDeclaration` | interface |
+| `OAuthTokens` | interface |
+| `PartnerOAuthDeclaration` | interface |
+| `PartnerScheduleDeclaration` | interface |
+| `PartnerToolModule` | interface |
+| `PartnerToolParameters` | type alias |
+| `PartnerWebhookDeclaration` | interface |
+| `PartnerWidgetDeclaration` | type alias |
+| `ScheduleInvocation` | interface |
+| `ScheduleResult` | interface |
+| `ToolClassificationProposal` | type alias |
+| `WebhookEvent` | interface |
+| `WebhookResult` | interface |
+| `WebhookSignatureDeclaration` | type alias |
+| `defineIntegration` | function |
+| `parseCronExpression` | function |
+| `validateIntegrationDefinitions` | function |

package/dist/components/index.d.ts

@@ -9,7 +9,8 @@
  * The SDK OWNS these implementations — the pre-inversion re-exports through
  * `@kit/integrations-core/components/*` are gone; core now re-exports FROM
  * here for first-party code (one source of truth, two consumption paths —
- * DEVELOPER_EXPERIENCE_PLAN.md §5.1). UI primitives come from `@ekanos/ui`
+ * one source of truth with two consumption paths. UI primitives come from
+ * `@ekanos/ui`
  * (the published slice of the host design system), never `@kit/ui`.
  *
  * Server seam: nothing here imports a server module. `OAuthActivationForm`
@@ -22,7 +23,7 @@
  * config hierarchy) provides it, the SDK's `Widget.*` reads it.
  *
  * Surface discipline: additions require an entry in
- * docs/devex/sdk-export-map.md ("`@ekanos/sdk/components`").
+ * api-report.md, regenerated by `pnpm --filter @ekanos/sdk api-report`.
  */
 export { Widget } from './widgets/widget.js';
 export { WidgetContext, type WidgetActions, type WidgetContextValue, type WidgetHealth, type WidgetMeta, type WidgetRenderState, type WidgetState, } from './widgets/widget-context.js';

package/dist/components/index.js

@@ -9,7 +9,8 @@
  * The SDK OWNS these implementations — the pre-inversion re-exports through
  * `@kit/integrations-core/components/*` are gone; core now re-exports FROM
  * here for first-party code (one source of truth, two consumption paths —
- * DEVELOPER_EXPERIENCE_PLAN.md §5.1). UI primitives come from `@ekanos/ui`
+ * one source of truth with two consumption paths. UI primitives come from
+ * `@ekanos/ui`
  * (the published slice of the host design system), never `@kit/ui`.
  *
  * Server seam: nothing here imports a server module. `OAuthActivationForm`
@@ -22,7 +23,7 @@
  * config hierarchy) provides it, the SDK's `Widget.*` reads it.
  *
  * Surface discipline: additions require an entry in
- * docs/devex/sdk-export-map.md ("`@ekanos/sdk/components`").
+ * api-report.md, regenerated by `pnpm --filter @ekanos/sdk api-report`.
  */
 export { Widget } from './widgets/widget.js';
 export { WidgetContext, } from './widgets/widget-context.js';

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EACL,aAAa,GAOd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["/**\n * @ekanos/sdk/components — client-side building blocks.\n *\n * Import from client components only. `Widget` is the compound API every\n * dashboard widget renders through; the activation forms are the two\n * sanctioned activation UX bases (credential-style and OAuth-style), and\n * `BaseMarketplaceTile` is the matching base for the marketplace tile.\n *\n * The SDK OWNS these implementations — the pre-inversion re-exports through\n * `@kit/integrations-core/components/*` are gone; core now re-exports FROM\n * here for first-party code (one source of truth, two consumption paths —\n * DEVELOPER_EXPERIENCE_PLAN.md §5.1). UI primitives come from `@ekanos/ui`\n * (the published slice of the host design system), never `@kit/ui`.\n *\n * Server seam: nothing here imports a server module. `OAuthActivationForm`\n * performs activation through the host-injected actions seam\n * (`IntegrationActivationProvider`, @ekanos/sdk/hooks) — a server-action\n * REFERENCE bound by the host, not server code shipped to the browser.\n *\n * `WidgetContext` is the single context identity both sides share: the\n * host's `DashboardWidgetProvider` (host chrome — persistence callbacks,\n * config hierarchy) provides it, the SDK's `Widget.*` reads it.\n *\n * Surface discipline: additions require an entry in\n * docs/devex/sdk-export-map.md (\"`@ekanos/sdk/components`\").\n */\n\nexport { Widget } from './widgets/widget';\nexport {\n  WidgetContext,\n  type WidgetActions,\n  type WidgetContextValue,\n  type WidgetHealth,\n  type WidgetMeta,\n  type WidgetRenderState,\n  type WidgetState,\n} from './widgets/widget-context';\nexport { WidgetPreviewProvider } from './widgets/widget-preview-provider';\nexport type { WidgetPreviewProviderProps } from './widgets/widget-preview-provider';\nexport { AiPromptChip } from './widgets/ai-prompt-chip';\nexport { AskIcon } from './widgets/ask-icon';\nexport { WidgetAskBar } from './widgets/widget-ask-bar';\nexport { WidgetDataLoading } from './widgets/widget-state-components';\n\nexport { BaseActivationForm } from './base-activation-form';\nexport type { BaseActivationFormProps } from './base-activation-form';\nexport {\n  ActivationDialog,\n  ActivationInline,\n  BaseActivationDialog,\n} from './base-activation-dialog';\n\nexport { BaseMarketplaceTile } from './base-marketplace-tile';\nexport type { BaseMarketplaceTileProps } from './base-marketplace-tile';\n\nexport { OAuthActivationForm } from './oauth-activation-form';\nexport type { OAuthActivationFormConfig } from './oauth-activation-form';\n\nexport { currentReturnPath } from './current-return-path';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EACL,aAAa,GAOd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["/**\n * @ekanos/sdk/components — client-side building blocks.\n *\n * Import from client components only. `Widget` is the compound API every\n * dashboard widget renders through; the activation forms are the two\n * sanctioned activation UX bases (credential-style and OAuth-style), and\n * `BaseMarketplaceTile` is the matching base for the marketplace tile.\n *\n * The SDK OWNS these implementations — the pre-inversion re-exports through\n * `@kit/integrations-core/components/*` are gone; core now re-exports FROM\n * here for first-party code (one source of truth, two consumption paths —\n * one source of truth with two consumption paths. UI primitives come from\n * `@ekanos/ui`\n * (the published slice of the host design system), never `@kit/ui`.\n *\n * Server seam: nothing here imports a server module. `OAuthActivationForm`\n * performs activation through the host-injected actions seam\n * (`IntegrationActivationProvider`, @ekanos/sdk/hooks) — a server-action\n * REFERENCE bound by the host, not server code shipped to the browser.\n *\n * `WidgetContext` is the single context identity both sides share: the\n * host's `DashboardWidgetProvider` (host chrome — persistence callbacks,\n * config hierarchy) provides it, the SDK's `Widget.*` reads it.\n *\n * Surface discipline: additions require an entry in\n * api-report.md, regenerated by `pnpm --filter @ekanos/sdk api-report`.\n */\n\nexport { Widget } from './widgets/widget';\nexport {\n  WidgetContext,\n  type WidgetActions,\n  type WidgetContextValue,\n  type WidgetHealth,\n  type WidgetMeta,\n  type WidgetRenderState,\n  type WidgetState,\n} from './widgets/widget-context';\nexport { WidgetPreviewProvider } from './widgets/widget-preview-provider';\nexport type { WidgetPreviewProviderProps } from './widgets/widget-preview-provider';\nexport { AiPromptChip } from './widgets/ai-prompt-chip';\nexport { AskIcon } from './widgets/ask-icon';\nexport { WidgetAskBar } from './widgets/widget-ask-bar';\nexport { WidgetDataLoading } from './widgets/widget-state-components';\n\nexport { BaseActivationForm } from './base-activation-form';\nexport type { BaseActivationFormProps } from './base-activation-form';\nexport {\n  ActivationDialog,\n  ActivationInline,\n  BaseActivationDialog,\n} from './base-activation-dialog';\n\nexport { BaseMarketplaceTile } from './base-marketplace-tile';\nexport type { BaseMarketplaceTileProps } from './base-marketplace-tile';\n\nexport { OAuthActivationForm } from './oauth-activation-form';\nexport type { OAuthActivationFormConfig } from './oauth-activation-form';\n\nexport { currentReturnPath } from './current-return-path';\n"]}

package/dist/components/widgets/widget-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"widget-context.js","sourceRoot":"","sources":["../../../src/components/widgets/widget-context.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAmDtC,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAC","sourcesContent":["'use client';\n\nimport { createContext } from 'react';\n\nimport type { WidgetAskContext } from '../../types/widget-ask-context';\n\nexport type WidgetRenderState =\n  | 'active'\n  | 'disabled'\n  | 'loading'\n  | 'error'\n  | 'inactive';\n\nexport interface WidgetState {\n  state: WidgetRenderState;\n  collapsed: boolean;\n  pinned: boolean;\n  pendingCollapse: boolean;\n  pendingPin: boolean;\n}\n\nexport interface WidgetActions {\n  toggleCollapsed: () => void;\n  togglePinned: () => void;\n}\n\nexport interface WidgetHealth {\n  status: 'healthy' | 'degraded' | 'unhealthy' | 'unknown';\n  lastSuccessAt?: string | null;\n  errorMessage?: string | null;\n}\n\nexport interface WidgetMeta {\n  widgetId: string;\n  title?: string;\n  subtitle?: string;\n  description?: string;\n  maxContentHeight?: string;\n  isCollapsible: boolean;\n  isPinnable: boolean;\n  askContext?: WidgetAskContext;\n  aiFooterEnabled: boolean;\n  className?: string;\n  /** Integration health for this widget's product, if known. */\n  health?: WidgetHealth;\n}\n\nexport interface WidgetContextValue {\n  state: WidgetState;\n  actions: WidgetActions;\n  meta: WidgetMeta;\n}\n\nexport const WidgetContext = createContext<WidgetContextValue | null>(null);\n"]}
+{"version":3,"file":"widget-context.js","sourceRoot":"","sources":["../../../src/components/widgets/widget-context.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AA+CtC,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAC","sourcesContent":["'use client';\n\nimport { createContext } from 'react';\n\nimport type { WidgetAskContext } from '../../types/widget-ask-context';\n\nexport type WidgetRenderState =\n  'active' | 'disabled' | 'loading' | 'error' | 'inactive';\n\nexport interface WidgetState {\n  state: WidgetRenderState;\n  collapsed: boolean;\n  pinned: boolean;\n  pendingCollapse: boolean;\n  pendingPin: boolean;\n}\n\nexport interface WidgetActions {\n  toggleCollapsed: () => void;\n  togglePinned: () => void;\n}\n\nexport interface WidgetHealth {\n  status: 'healthy' | 'degraded' | 'unhealthy' | 'unknown';\n  lastSuccessAt?: string | null;\n  errorMessage?: string | null;\n}\n\nexport interface WidgetMeta {\n  widgetId: string;\n  title?: string;\n  subtitle?: string;\n  description?: string;\n  maxContentHeight?: string;\n  isCollapsible: boolean;\n  isPinnable: boolean;\n  askContext?: WidgetAskContext;\n  aiFooterEnabled: boolean;\n  className?: string;\n  /** Integration health for this widget's product, if known. */\n  health?: WidgetHealth;\n}\n\nexport interface WidgetContextValue {\n  state: WidgetState;\n  actions: WidgetActions;\n  meta: WidgetMeta;\n}\n\nexport const WidgetContext = createContext<WidgetContextValue | null>(null);\n"]}

package/dist/context/index.d.ts

@@ -11,7 +11,7 @@
  * type-only from the SDK root — import them from `@ekanos/sdk`.
  *
  * Surface discipline: additions require an entry in
- * docs/devex/sdk-export-map.md ("Context & testing entrypoints (P1)").
+ * api-report.md, regenerated by `pnpm --filter @ekanos/sdk api-report`.
  */
 export { EgressDeniedError, SecretAccessError, StorageValidationError, } from './errors.js';
 export { isEgressAllowed } from './egress.js';

package/dist/context/index.js

@@ -11,7 +11,7 @@
  * type-only from the SDK root — import them from `@ekanos/sdk`.
  *
  * Surface discipline: additions require an entry in
- * docs/devex/sdk-export-map.md ("Context & testing entrypoints (P1)").
+ * api-report.md, regenerated by `pnpm --filter @ekanos/sdk api-report`.
  */
 export { EgressDeniedError, SecretAccessError, StorageValidationError, } from './errors.js';
 export { isEgressAllowed } from './egress.js';

package/dist/context/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,GAEf,MAAM,mBAAmB,CAAC","sourcesContent":["/**\n * @ekanos/sdk/context — the capability context's pure shared runtime.\n *\n * Dependency-pure and isomorphic (zod only — no `@kit/*`, no `server-only`):\n * the error classes, the egress allowlist matcher, and the storage\n * validators are ONE implementation shared by the `@ekanos/sdk/testing`\n * mock and the production host wrapper, so behavior proven against the mock\n * holds in prod.\n *\n * The context TYPES (`IntegrationContext` and friends) are exported\n * type-only from the SDK root — import them from `@ekanos/sdk`.\n *\n * Surface discipline: additions require an entry in\n * docs/devex/sdk-export-map.md (\"Context & testing entrypoints (P1)\").\n */\n\nexport {\n  EgressDeniedError,\n  SecretAccessError,\n  StorageValidationError,\n} from './errors';\nexport { isEgressAllowed } from './egress';\nexport {\n  assertStorageKeyDeclared,\n  assertStorageKeyWritable,\n  isStorageKeyClientReadable,\n  parseStorageValue,\n  resolveStorageKeyDeclaration,\n} from './storage-validation';\nexport {\n  requireContext,\n  type IntegrationContextCarrier,\n} from './require-context';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,GAEf,MAAM,mBAAmB,CAAC","sourcesContent":["/**\n * @ekanos/sdk/context — the capability context's pure shared runtime.\n *\n * Dependency-pure and isomorphic (zod only — no `@kit/*`, no `server-only`):\n * the error classes, the egress allowlist matcher, and the storage\n * validators are ONE implementation shared by the `@ekanos/sdk/testing`\n * mock and the production host wrapper, so behavior proven against the mock\n * holds in prod.\n *\n * The context TYPES (`IntegrationContext` and friends) are exported\n * type-only from the SDK root — import them from `@ekanos/sdk`.\n *\n * Surface discipline: additions require an entry in\n * api-report.md, regenerated by `pnpm --filter @ekanos/sdk api-report`.\n */\n\nexport {\n  EgressDeniedError,\n  SecretAccessError,\n  StorageValidationError,\n} from './errors';\nexport { isEgressAllowed } from './egress';\nexport {\n  assertStorageKeyDeclared,\n  assertStorageKeyWritable,\n  isStorageKeyClientReadable,\n  parseStorageValue,\n  resolveStorageKeyDeclaration,\n} from './storage-validation';\nexport {\n  requireContext,\n  type IntegrationContextCarrier,\n} from './require-context';\n"]}

package/dist/context/types.d.ts

@@ -6,6 +6,6 @@
  * every existing `@ekanos/sdk` import path (`./types`, `../context/types`,
  * the root barrel) keeps resolving unchanged.
  *
- * Spec: docs/devex/capability-context-proposal.md (all six §7 rulings).
+ * The authoring guide for everything below is this package's README.
  */
 export type { IntegrationActor, IntegrationContext, IntegrationStorage, ScopedStore, IntegrationSecrets, IntegrationFetch, IntegrationLogger, StorageEntry, StorageWriteOptions, StorageSchemas, StorageSchemaMap, StorageScopeSchemas, StorageKeyDeclaration, StorageKeyDeclarationInput, StorageKeySchema, } from '@ekanos/integration-schema';

package/dist/context/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * The capability-context types now live in `@ekanos/integration-schema` (the\n * dependency-pure package both `@ekanos/sdk` and `@kit/integrations-core`\n * depend on) so the canonical integration-definition schema can reference\n * `IntegrationContext` without a package cycle. This file re-exports them so\n * every existing `@ekanos/sdk` import path (`./types`, `../context/types`,\n * the root barrel) keeps resolving unchanged.\n *\n * Spec: docs/devex/capability-context-proposal.md (all six §7 rulings).\n */\nexport type {\n  IntegrationActor,\n  IntegrationContext,\n  IntegrationStorage,\n  ScopedStore,\n  IntegrationSecrets,\n  IntegrationFetch,\n  IntegrationLogger,\n  StorageEntry,\n  StorageWriteOptions,\n  StorageSchemas,\n  StorageSchemaMap,\n  StorageScopeSchemas,\n  StorageKeyDeclaration,\n  StorageKeyDeclarationInput,\n  StorageKeySchema,\n} from '@ekanos/integration-schema';\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * The capability-context types now live in `@ekanos/integration-schema` (the\n * dependency-pure package both `@ekanos/sdk` and `@kit/integrations-core`\n * depend on) so the canonical integration-definition schema can reference\n * `IntegrationContext` without a package cycle. This file re-exports them so\n * every existing `@ekanos/sdk` import path (`./types`, `../context/types`,\n * the root barrel) keeps resolving unchanged.\n *\n * The authoring guide for everything below is this package's README.\n */\nexport type {\n  IntegrationActor,\n  IntegrationContext,\n  IntegrationStorage,\n  ScopedStore,\n  IntegrationSecrets,\n  IntegrationFetch,\n  IntegrationLogger,\n  StorageEntry,\n  StorageWriteOptions,\n  StorageSchemas,\n  StorageSchemaMap,\n  StorageScopeSchemas,\n  StorageKeyDeclaration,\n  StorageKeyDeclarationInput,\n  StorageKeySchema,\n} from '@ekanos/integration-schema';\n"]}

package/dist/hooks/activation-actions-context.d.ts

@@ -1,12 +1,12 @@
 import { type ReactNode } from 'react';
 /**
  * The host-injection seam for integration activation (the SDK inversion,
- * DEVELOPER_EXPERIENCE_PLAN.md §5.1).
+ * so there is one source of truth with two consumption paths).
  *
  * A published SDK cannot import the host's `'use server'` activation actions
  * — that import is what used to drag `server-only` (via `@kit/next/actions`)
- * into every partner client graph and broke partner tests on day one
- * (sdk-export-map.md, BLOCKER 2). Instead the HOST binds its real server
+ * into every partner client graph and broke partner tests on day one.
+ * Instead the HOST binds its real server
  * actions once, at the root of its client tree:
  *
  * ```tsx
@@ -66,7 +66,7 @@ export interface IntegrationActivationActions {
 }
 /**
  * Host-mounted provider that binds the real activation server actions.
- * Mounted once at the root of the host's client tree (apps/web root
+ * Mounted once at the root of the host's client tree (the app's root
  * providers; the harness mounts it with fixture actions).
  */
 export declare function IntegrationActivationProvider({ actions, children, }: {

package/dist/hooks/activation-actions-context.js

@@ -4,7 +4,7 @@ import { createContext, use, useMemo } from 'react';
 const IntegrationActivationContext = createContext(null);
 /**
  * Host-mounted provider that binds the real activation server actions.
- * Mounted once at the root of the host's client tree (apps/web root
+ * Mounted once at the root of the host's client tree (the app's root
  * providers; the harness mounts it with fixture actions).
  */
 export function IntegrationActivationProvider({ actions, children, }) {

package/dist/hooks/activation-actions-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"activation-actions-context.js","sourceRoot":"","sources":["../../src/hooks/activation-actions-context.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAkB,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AA8EpE,MAAM,4BAA4B,GAChC,aAAa,CAAsC,IAAI,CAAC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAC5C,OAAO,EACP,QAAQ,GAIT;IACC,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,EACtE,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CACvC,CAAC;IAEF,OAAO,CACL,KAAC,4BAA4B,IAAC,KAAK,EAAE,KAAK,YACvC,QAAQ,GACoB,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,wBAAwB,GAC5B,yEAAyE;IACzE,4DAA4D;IAC5D,oEAAoE;IACpE,eAAe,CAAC;AAElB;;;GAGG;AACH,MAAM,UAAU,+BAA+B;IAC7C,MAAM,OAAO,GAAG,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAElD,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAE5B,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,OAAO,CAAC,MAAM,CACZ,IAAI,KAAK,CAAC,wBAAwB,CAAC,CACpC,CAAC;QAEJ,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAClD,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAChB,CAAC","sourcesContent":["'use client';\n\nimport { type ReactNode, createContext, use, useMemo } from 'react';\n\n/**\n * The host-injection seam for integration activation (the SDK inversion,\n * DEVELOPER_EXPERIENCE_PLAN.md §5.1).\n *\n * A published SDK cannot import the host's `'use server'` activation actions\n * — that import is what used to drag `server-only` (via `@kit/next/actions`)\n * into every partner client graph and broke partner tests on day one\n * (sdk-export-map.md, BLOCKER 2). Instead the HOST binds its real server\n * actions once, at the root of its client tree:\n *\n * ```tsx\n * // host chrome (e.g. @kit/integrations-core's bridge component)\n * <IntegrationActivationProvider actions={{ activate, deactivate }}>\n *   {children}\n * </IntegrationActivationProvider>\n * ```\n *\n * and `useActivateIntegration()` / `useDeactivateIntegration()` keep their\n * zero-argument call signature everywhere — first-party integrations,\n * examples, and partner code are byte-identical before and after the\n * inversion. Server-action references are serializable client values in\n * React 19, so passing them through context is sanctioned.\n *\n * Outside a provider the hooks reject AT CALL TIME with an actionable\n * error (mirroring `useAskAssistant`'s no-op-outside-provider contract,\n * but loud rather than silent — a swallowed activation would look like a\n * hung form).\n */\n\n/** Input accepted by the host's activate action (BaseActivationSchema). */\nexport interface ActivateIntegrationInput {\n  accountId: string;\n  sourceId?: string;\n  productId?: string;\n  integrationSlug: string;\n  activationData?: unknown;\n  /**\n   * The TEAM account context the user activated within — separate from\n   * `accountId`, which for `scope: 'user'` integrations is the personal\n   * account. Optional; the host falls back to `accountId` when absent.\n   */\n  teamAccountId?: string;\n  /** The host schema is passthrough: extra integration fields ride along. */\n  [key: string]: unknown;\n}\n\n/** Input accepted by the host's deactivate action (DeactivationSchema). */\nexport interface DeactivateIntegrationInput {\n  accountId: string;\n  productId?: string;\n  integrationSlug: string;\n  [key: string]: unknown;\n}\n\n/**\n * The host action envelope. Host actions return richer payloads; the SDK\n * only relies on the `success` / `errorMessage` pair.\n */\nexport type IntegrationActionResult = {\n  success?: boolean;\n  errorMessage?: string;\n} & Record<string, unknown>;\n\nexport type ActivateIntegrationAction = (\n  input: ActivateIntegrationInput,\n) => Promise<IntegrationActionResult | undefined>;\n\nexport type DeactivateIntegrationAction = (\n  input: DeactivateIntegrationInput,\n) => Promise<IntegrationActionResult | undefined>;\n\nexport interface IntegrationActivationActions {\n  activate: ActivateIntegrationAction;\n  deactivate: DeactivateIntegrationAction;\n}\n\nconst IntegrationActivationContext =\n  createContext<IntegrationActivationActions | null>(null);\n\n/**\n * Host-mounted provider that binds the real activation server actions.\n * Mounted once at the root of the host's client tree (apps/web root\n * providers; the harness mounts it with fixture actions).\n */\nexport function IntegrationActivationProvider({\n  actions,\n  children,\n}: {\n  actions: IntegrationActivationActions;\n  children: ReactNode;\n}) {\n  const value = useMemo(\n    () => ({ activate: actions.activate, deactivate: actions.deactivate }),\n    [actions.activate, actions.deactivate],\n  );\n\n  return (\n    <IntegrationActivationContext value={value}>\n      {children}\n    </IntegrationActivationContext>\n  );\n}\n\nconst MISSING_PROVIDER_MESSAGE =\n  'No IntegrationActivationProvider is mounted. The host application must ' +\n  'bind its activation server actions (see @ekanos/sdk/hooks ' +\n  'IntegrationActivationProvider) above any component that activates ' +\n  'integrations.';\n\n/**\n * Internal: resolve the host-bound actions, or a pair that rejects loudly.\n * Not exported from the entrypoint — hooks and the OAuth form consume it.\n */\nexport function useIntegrationActivationActions(): IntegrationActivationActions {\n  const context = use(IntegrationActivationContext);\n\n  return useMemo(() => {\n    if (context) return context;\n\n    const reject = () =>\n      Promise.reject<IntegrationActionResult>(\n        new Error(MISSING_PROVIDER_MESSAGE),\n      );\n\n    return { activate: reject, deactivate: reject };\n  }, [context]);\n}\n"]}
+{"version":3,"file":"activation-actions-context.js","sourceRoot":"","sources":["../../src/hooks/activation-actions-context.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAkB,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AA8EpE,MAAM,4BAA4B,GAChC,aAAa,CAAsC,IAAI,CAAC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAC5C,OAAO,EACP,QAAQ,GAIT;IACC,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,EACtE,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CACvC,CAAC;IAEF,OAAO,CACL,KAAC,4BAA4B,IAAC,KAAK,EAAE,KAAK,YACvC,QAAQ,GACoB,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,wBAAwB,GAC5B,yEAAyE;IACzE,4DAA4D;IAC5D,oEAAoE;IACpE,eAAe,CAAC;AAElB;;;GAGG;AACH,MAAM,UAAU,+BAA+B;IAC7C,MAAM,OAAO,GAAG,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAElD,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAE5B,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,OAAO,CAAC,MAAM,CACZ,IAAI,KAAK,CAAC,wBAAwB,CAAC,CACpC,CAAC;QAEJ,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAClD,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAChB,CAAC","sourcesContent":["'use client';\n\nimport { type ReactNode, createContext, use, useMemo } from 'react';\n\n/**\n * The host-injection seam for integration activation (the SDK inversion,\n * so there is one source of truth with two consumption paths).\n *\n * A published SDK cannot import the host's `'use server'` activation actions\n * — that import is what used to drag `server-only` (via `@kit/next/actions`)\n * into every partner client graph and broke partner tests on day one.\n * Instead the HOST binds its real server\n * actions once, at the root of its client tree:\n *\n * ```tsx\n * // host chrome (e.g. @kit/integrations-core's bridge component)\n * <IntegrationActivationProvider actions={{ activate, deactivate }}>\n *   {children}\n * </IntegrationActivationProvider>\n * ```\n *\n * and `useActivateIntegration()` / `useDeactivateIntegration()` keep their\n * zero-argument call signature everywhere — first-party integrations,\n * examples, and partner code are byte-identical before and after the\n * inversion. Server-action references are serializable client values in\n * React 19, so passing them through context is sanctioned.\n *\n * Outside a provider the hooks reject AT CALL TIME with an actionable\n * error (mirroring `useAskAssistant`'s no-op-outside-provider contract,\n * but loud rather than silent — a swallowed activation would look like a\n * hung form).\n */\n\n/** Input accepted by the host's activate action (BaseActivationSchema). */\nexport interface ActivateIntegrationInput {\n  accountId: string;\n  sourceId?: string;\n  productId?: string;\n  integrationSlug: string;\n  activationData?: unknown;\n  /**\n   * The TEAM account context the user activated within — separate from\n   * `accountId`, which for `scope: 'user'` integrations is the personal\n   * account. Optional; the host falls back to `accountId` when absent.\n   */\n  teamAccountId?: string;\n  /** The host schema is passthrough: extra integration fields ride along. */\n  [key: string]: unknown;\n}\n\n/** Input accepted by the host's deactivate action (DeactivationSchema). */\nexport interface DeactivateIntegrationInput {\n  accountId: string;\n  productId?: string;\n  integrationSlug: string;\n  [key: string]: unknown;\n}\n\n/**\n * The host action envelope. Host actions return richer payloads; the SDK\n * only relies on the `success` / `errorMessage` pair.\n */\nexport type IntegrationActionResult = {\n  success?: boolean;\n  errorMessage?: string;\n} & Record<string, unknown>;\n\nexport type ActivateIntegrationAction = (\n  input: ActivateIntegrationInput,\n) => Promise<IntegrationActionResult | undefined>;\n\nexport type DeactivateIntegrationAction = (\n  input: DeactivateIntegrationInput,\n) => Promise<IntegrationActionResult | undefined>;\n\nexport interface IntegrationActivationActions {\n  activate: ActivateIntegrationAction;\n  deactivate: DeactivateIntegrationAction;\n}\n\nconst IntegrationActivationContext =\n  createContext<IntegrationActivationActions | null>(null);\n\n/**\n * Host-mounted provider that binds the real activation server actions.\n * Mounted once at the root of the host's client tree (the app's root\n * providers; the harness mounts it with fixture actions).\n */\nexport function IntegrationActivationProvider({\n  actions,\n  children,\n}: {\n  actions: IntegrationActivationActions;\n  children: ReactNode;\n}) {\n  const value = useMemo(\n    () => ({ activate: actions.activate, deactivate: actions.deactivate }),\n    [actions.activate, actions.deactivate],\n  );\n\n  return (\n    <IntegrationActivationContext value={value}>\n      {children}\n    </IntegrationActivationContext>\n  );\n}\n\nconst MISSING_PROVIDER_MESSAGE =\n  'No IntegrationActivationProvider is mounted. The host application must ' +\n  'bind its activation server actions (see @ekanos/sdk/hooks ' +\n  'IntegrationActivationProvider) above any component that activates ' +\n  'integrations.';\n\n/**\n * Internal: resolve the host-bound actions, or a pair that rejects loudly.\n * Not exported from the entrypoint — hooks and the OAuth form consume it.\n */\nexport function useIntegrationActivationActions(): IntegrationActivationActions {\n  const context = use(IntegrationActivationContext);\n\n  return useMemo(() => {\n    if (context) return context;\n\n    const reject = () =>\n      Promise.reject<IntegrationActionResult>(\n        new Error(MISSING_PROVIDER_MESSAGE),\n      );\n\n    return { activate: reject, deactivate: reject };\n  }, [context]);\n}\n"]}

package/dist/hooks/index.d.ts

@@ -4,7 +4,7 @@
  * Import from client components only. The SDK OWNS these implementations;
  * `@kit/integrations-core/hooks` re-exports them for first-party code, so
  * there is one source of truth with two consumption paths
- * (DEVELOPER_EXPERIENCE_PLAN.md §5.1).
+ * so there is one source of truth with two consumption paths.
  *
  * Server seam: nothing here imports a server module. The activation hooks
  * reach the host's `'use server'` actions ONLY through the
@@ -13,7 +13,7 @@
  * of `server-only` in a partner's module graph.
  *
  * Surface discipline: additions require an entry in
- * docs/devex/sdk-export-map.md ("`@ekanos/sdk/hooks`").
+ * api-report.md, regenerated by `pnpm --filter @ekanos/sdk api-report`.
  */
 export { useActivateIntegration, useDeactivateIntegration, } from './use-activate-integration.js';
 export { IntegrationActivationProvider } from './activation-actions-context.js';

package/dist/hooks/index.js

@@ -4,7 +4,7 @@
  * Import from client components only. The SDK OWNS these implementations;
  * `@kit/integrations-core/hooks` re-exports them for first-party code, so
  * there is one source of truth with two consumption paths
- * (DEVELOPER_EXPERIENCE_PLAN.md §5.1).
+ * so there is one source of truth with two consumption paths.
  *
  * Server seam: nothing here imports a server module. The activation hooks
  * reach the host's `'use server'` actions ONLY through the
@@ -13,7 +13,7 @@
  * of `server-only` in a partner's module graph.
  *
  * Surface discipline: additions require an entry in
- * docs/devex/sdk-export-map.md ("`@ekanos/sdk/hooks`").
+ * api-report.md, regenerated by `pnpm --filter @ekanos/sdk api-report`.
  */
 // Activation (host-injected server actions)
 export { useActivateIntegration, useDeactivateIntegration, } from './use-activate-integration.js';

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,4CAA4C;AAC5C,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAU7E,kDAAkD;AAClD,mEAAmE;AACnE,qEAAqE;AACrE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAGrC,0BAA0B;AAC1B,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAQvC,mBAAmB;AACnB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAQtD,wBAAwB;AACxB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,uBAAuB,GACxB,MAAM,yBAAyB,CAAC","sourcesContent":["/**\n * @ekanos/sdk/hooks — client-side hooks.\n *\n * Import from client components only. The SDK OWNS these implementations;\n * `@kit/integrations-core/hooks` re-exports them for first-party code, so\n * there is one source of truth with two consumption paths\n * (DEVELOPER_EXPERIENCE_PLAN.md §5.1).\n *\n * Server seam: nothing here imports a server module. The activation hooks\n * reach the host's `'use server'` actions ONLY through the\n * `IntegrationActivationProvider` injection seam\n * (activation-actions-context.tsx) — that is what keeps this entrypoint free\n * of `server-only` in a partner's module graph.\n *\n * Surface discipline: additions require an entry in\n * docs/devex/sdk-export-map.md (\"`@ekanos/sdk/hooks`\").\n */\n\n// Activation (host-injected server actions)\nexport {\n  useActivateIntegration,\n  useDeactivateIntegration,\n} from './use-activate-integration';\nexport { IntegrationActivationProvider } from './activation-actions-context';\nexport type {\n  ActivateIntegrationAction,\n  ActivateIntegrationInput,\n  DeactivateIntegrationAction,\n  DeactivateIntegrationInput,\n  IntegrationActionResult,\n  IntegrationActivationActions,\n} from './activation-actions-context';\n\n// Generic client-side storage bridge (host route:\n// GET /api/integrations/[slug]/storage). Serves only keys declared\n// `clientReadable: true`; a key that did not opt in reads as absent.\nexport {\n  fetchIntegrationStorage,\n  integrationStorageUrl,\n} from './fetch-integration-storage';\nexport type { FetchIntegrationStorageOptions } from './fetch-integration-storage';\n\n// OAuth connection status\nexport {\n  useOAuthConnectionStatus,\n  useOAuthWidgetGate,\n} from './use-oauth-connection-status';\nexport type {\n  ConnectionCheckAction,\n  ConnectionCheckResult,\n  OAuthErrorParam,\n  UseOAuthConnectionStatusOptions,\n} from './use-oauth-connection-status';\n\n// Widget Event Bus\nexport { WidgetEventProvider, useWidgetEventBus } from './widget-event-context';\nexport { useWidgetEvents } from './use-widget-events';\nexport type {\n  PublishEventInput,\n  WidgetEvent,\n  WidgetEventFilter,\n  WidgetEventSubscriber,\n} from './widget-event-types';\n\n// Widget Ask-Bar Bridge\nexport {\n  AskAssistantProvider,\n  useAskAssistant,\n  useRegisterAskAssistant,\n} from './ask-assistant-context';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,4CAA4C;AAC5C,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAU7E,kDAAkD;AAClD,mEAAmE;AACnE,qEAAqE;AACrE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAGrC,0BAA0B;AAC1B,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAQvC,mBAAmB;AACnB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAQtD,wBAAwB;AACxB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,uBAAuB,GACxB,MAAM,yBAAyB,CAAC","sourcesContent":["/**\n * @ekanos/sdk/hooks — client-side hooks.\n *\n * Import from client components only. The SDK OWNS these implementations;\n * `@kit/integrations-core/hooks` re-exports them for first-party code, so\n * there is one source of truth with two consumption paths\n * so there is one source of truth with two consumption paths.\n *\n * Server seam: nothing here imports a server module. The activation hooks\n * reach the host's `'use server'` actions ONLY through the\n * `IntegrationActivationProvider` injection seam\n * (activation-actions-context.tsx) — that is what keeps this entrypoint free\n * of `server-only` in a partner's module graph.\n *\n * Surface discipline: additions require an entry in\n * api-report.md, regenerated by `pnpm --filter @ekanos/sdk api-report`.\n */\n\n// Activation (host-injected server actions)\nexport {\n  useActivateIntegration,\n  useDeactivateIntegration,\n} from './use-activate-integration';\nexport { IntegrationActivationProvider } from './activation-actions-context';\nexport type {\n  ActivateIntegrationAction,\n  ActivateIntegrationInput,\n  DeactivateIntegrationAction,\n  DeactivateIntegrationInput,\n  IntegrationActionResult,\n  IntegrationActivationActions,\n} from './activation-actions-context';\n\n// Generic client-side storage bridge (host route:\n// GET /api/integrations/[slug]/storage). Serves only keys declared\n// `clientReadable: true`; a key that did not opt in reads as absent.\nexport {\n  fetchIntegrationStorage,\n  integrationStorageUrl,\n} from './fetch-integration-storage';\nexport type { FetchIntegrationStorageOptions } from './fetch-integration-storage';\n\n// OAuth connection status\nexport {\n  useOAuthConnectionStatus,\n  useOAuthWidgetGate,\n} from './use-oauth-connection-status';\nexport type {\n  ConnectionCheckAction,\n  ConnectionCheckResult,\n  OAuthErrorParam,\n  UseOAuthConnectionStatusOptions,\n} from './use-oauth-connection-status';\n\n// Widget Event Bus\nexport { WidgetEventProvider, useWidgetEventBus } from './widget-event-context';\nexport { useWidgetEvents } from './use-widget-events';\nexport type {\n  PublishEventInput,\n  WidgetEvent,\n  WidgetEventFilter,\n  WidgetEventSubscriber,\n} from './widget-event-types';\n\n// Widget Ask-Bar Bridge\nexport {\n  AskAssistantProvider,\n  useAskAssistant,\n  useRegisterAskAssistant,\n} from './ask-assistant-context';\n"]}