@awiki/dsh-plugin 0.2.0-rc.4

package/lib/types/client/slots.d.ts

@@ -0,0 +1,74 @@
+/** Composed props and injected browser operations for the AWiki overlay. */
+import type { HostObservable, InjectFace, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { AwikiAttachmentId, AwikiConversationId, AwikiDownloadedAttachment, AwikiIdentity, AwikiMessageId, AwikiRegistrationOtpRequest, AwikiRegistrationOtpResult, AwikiRegistrationRequest, AwikiConversationSummary, AwikiSession } from '@awiki/dsh-plugin/types';
+import type { AwikiActionResult, AwikiView } from './controller.ts';
+import type { createAwikiOverlayStore } from './store.ts';
+/** Injected browser actions; components never receive Cordis ctx or Remote. */
+export interface AwikiInjected {
+    hooks: {
+        /** One controller snapshot shared by the trigger and drawer. */
+        awiki: HostObservable<AwikiView>;
+    };
+    /** Load browser-safe policy, identity, and the first conversation page, then keep unread state fresh. */
+    open: () => Promise<AwikiActionResult>;
+    /** Stop polling and invalidate work when the overlay is unmounted. */
+    close: () => void;
+    /**
+     * Request a registration verification code.
+     * @param request - desired Handle and verification phone number.
+     */
+    sendRegistrationOtp: (request: AwikiRegistrationOtpRequest) => Promise<AwikiActionResult<AwikiRegistrationOtpResult>>;
+    /**
+     * Register the deployment's shared identity.
+     * @param request - Handle, phone number, and verification code.
+     */
+    registerIdentity: (request: AwikiRegistrationRequest) => Promise<AwikiActionResult<AwikiIdentity>>;
+    /** Update the deployment identity's public WNS display name. */
+    updateDisplayName: (displayName: string) => Promise<AwikiActionResult<AwikiIdentity>>;
+    /** Load the next conversation page with the Host-owned cursor. */
+    loadMoreConversations: () => Promise<AwikiActionResult>;
+    /**
+     * Open an existing direct conversation or a local draft for one Handle.
+     * @param handle - peer Handle or DID typed by the user.
+     */
+    startDirectChat: (handle: string) => Promise<AwikiActionResult>;
+    /**
+     * Select one conversation or return to the roster.
+     * @param conversationId - conversation identifier, or `null` for the roster.
+     */
+    selectConversation: (conversationId: AwikiConversationId | null) => Promise<AwikiActionResult>;
+    /** Load the next older history page for the selected conversation. */
+    loadOlderHistory: () => Promise<AwikiActionResult>;
+    /** Generate or regenerate the selected conversation's AI summary. */
+    summarizeConversation: () => Promise<AwikiActionResult<AwikiConversationSummary>>;
+    /** Toggle a cached summary without invoking the model. */
+    setSummaryCollapsed: (conversationId: AwikiConversationId, collapsed: boolean) => void;
+    /**
+     * Send text to the selected conversation.
+     * @param text - non-empty composer text.
+     */
+    sendText: (text: string) => Promise<AwikiActionResult>;
+    /**
+     * Send one JSON-safe file payload to the selected conversation.
+     * @param file - file metadata, base64 bytes, and an optional caption.
+     */
+    sendAttachment: (file: {
+        readonly fileName: string;
+        readonly mimeType: string;
+        readonly bytesBase64: string;
+        readonly caption?: string;
+    }) => Promise<AwikiActionResult>;
+    /**
+     * Download one attachment through its containing message.
+     * @param messageId - message that contains the attachment.
+     * @param attachmentId - attachment selected by the user.
+     */
+    downloadAttachment: (messageId: AwikiMessageId, attachmentId: AwikiAttachmentId) => Promise<AwikiActionResult<AwikiDownloadedAttachment>>;
+    /** Sign out on this installation without deleting local identity data. */
+    logout: () => Promise<AwikiActionResult<AwikiSession>>;
+    /** Resume the same locally preserved identity. */
+    login: () => Promise<AwikiActionResult<AwikiSession>>;
+}
+/** Full four-share props of the floating launcher and anchored `shell.overlay` panel. */
+export type AwikiOverlayProps = PropsRuntime<'shell.overlay'> & PropsStore<ReturnType<typeof createAwikiOverlayStore>> & InjectFace<AwikiInjected>;
+//# sourceMappingURL=slots.d.ts.map

package/lib/types/client/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../../src/client/slots.ts"],"names":[],"mappings":"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"}

package/lib/types/client/slots.js

@@ -0,0 +1,3 @@
+/** Composed props and injected browser operations for the AWiki overlay. */
+export {};
+//# sourceMappingURL=slots.js.map

package/lib/types/client/slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../../../src/client/slots.ts"],"names":[],"mappings":"AAAA,4EAA4E"}

package/lib/types/client/store.d.ts

@@ -0,0 +1,18 @@
+/** Root-scoped interaction state for the AWiki overlay. */
+import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-runtime/client';
+/** State that survives the overlay entry's component remounts. */
+export interface AwikiOverlayState {
+    open: boolean;
+}
+type AwikiOverlayActions = {
+    open: (draft: AwikiOverlayState) => void;
+    close: (draft: AwikiOverlayState) => void;
+    toggle: (draft: AwikiOverlayState) => void;
+};
+/**
+ * Create the overlay's root-scoped interaction store.
+ * @returns a fresh framework store handle.
+ */
+export declare function createAwikiOverlayStore(): EngineStoreHandle<AwikiOverlayState, AwikiOverlayActions>;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/lib/types/client/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/client/store.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAE5F,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAA;CACd;AAED,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACxC,KAAK,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACzC,MAAM,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAC3C,CAAA;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CASnG"}

package/lib/types/client/store.js

@@ -0,0 +1,17 @@
+/** Root-scoped interaction state for the AWiki overlay. */
+import { defineStore } from '@deepseek-ai/dsh-client-runtime/client';
+/**
+ * Create the overlay's root-scoped interaction store.
+ * @returns a fresh framework store handle.
+ */
+export function createAwikiOverlayStore() {
+    return defineStore({
+        init: () => ({ open: false }),
+        actions: {
+            open: (draft) => { draft.open = true; },
+            close: (draft) => { draft.open = false; },
+            toggle: (draft) => { draft.open = !draft.open; },
+        },
+    });
+}
+//# sourceMappingURL=store.js.map

package/lib/types/client/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/client/store.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,OAAO,EAAE,WAAW,EAA0B,MAAM,wCAAwC,CAAA;AAa5F;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,WAAW,CAAC;QACjB,IAAI,EAAE,GAAsB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAChD,OAAO,EAAE;YACP,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA,CAAC,CAAC;YACtC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,CAAA,CAAC,CAAC;YACxC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAA,CAAC,CAAC;SAChD;KACF,CAAC,CAAA;AACJ,CAAC"}

package/lib/types/client.d.ts

@@ -0,0 +1,3 @@
+/** Client compilation projection of the AWiki Remote data types. */
+export type * from './types.ts';
+//# sourceMappingURL=client.d.ts.map

package/lib/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,mBAAmB,YAAY,CAAA"}

package/lib/types/client.js

@@ -0,0 +1,3 @@
+/** Client compilation projection of the AWiki Remote data types. */
+export {};
+//# sourceMappingURL=client.js.map

package/lib/types/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,oEAAoE"}

package/lib/types/domain.d.ts

@@ -0,0 +1,10 @@
+/** Client-safe AWiki Handle provider domain constants and validation. */
+/** Default Handle provider domain for new AWiki deployments. */
+export declare const DEFAULT_AWIKI_DOMAIN = "awiki.ai";
+/** Field carrying the Handle provider domain in the AWiki settings namespace. */
+export declare const AWIKI_DOMAIN_FIELD = "domain";
+/** Settings namespace owned by the AWiki plugin. */
+export declare const AWIKI_SETTINGS_NAMESPACE = "awiki";
+/** Normalize and validate one DNS provider domain. */
+export declare function normalizeAwikiDomain(raw: string, field?: string): string;
+//# sourceMappingURL=domain.d.ts.map

package/lib/types/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/domain.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,gEAAgE;AAChE,eAAO,MAAM,oBAAoB,aAAa,CAAA;AAE9C,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,WAAW,CAAA;AAE1C,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,UAAU,CAAA;AAE/C,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAW,GAAG,MAAM,CAQ1E"}

package/lib/types/domain.js

@@ -0,0 +1,18 @@
+/** Client-safe AWiki Handle provider domain constants and validation. */
+/** Default Handle provider domain for new AWiki deployments. */
+export const DEFAULT_AWIKI_DOMAIN = 'awiki.ai';
+/** Field carrying the Handle provider domain in the AWiki settings namespace. */
+export const AWIKI_DOMAIN_FIELD = 'domain';
+/** Settings namespace owned by the AWiki plugin. */
+export const AWIKI_SETTINGS_NAMESPACE = 'awiki';
+/** Normalize and validate one DNS provider domain. */
+export function normalizeAwikiDomain(raw, field = 'domain') {
+    const value = raw.trim().toLowerCase();
+    const valid = /^(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/u
+        .test(value);
+    if (value.length > 253 || !valid) {
+        throw new TypeError(`awiki: ${field} must contain a valid DNS domain`);
+    }
+    return value;
+}
+//# sourceMappingURL=domain.js.map

package/lib/types/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../src/domain.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAA;AAE9C,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAA;AAE1C,oDAAoD;AACpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAA;AAE/C,sDAAsD;AACtD,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,KAAK,GAAG,QAAQ;IAChE,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACtC,MAAM,KAAK,GAAG,iGAAiG;SAC5G,IAAI,CAAC,KAAK,CAAC,CAAA;IACd,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,UAAU,KAAK,kCAAkC,CAAC,CAAA;IACxE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/lib/types/index.d.ts

@@ -0,0 +1,188 @@
+/** Unified AWiki identity, messaging, attachment, Remote, and model-tool service. */
+import { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { AwikiClearLocalDataRequest, AwikiClearLocalDataResult, AwikiConversation, AwikiConversationSummary, AwikiDownloadAttachmentRequest, AwikiDownloadedAttachment, AwikiHistoryRequest, AwikiHostClient, AwikiIdentity, AwikiLogoutRequest, AwikiMessage, AwikiMarkConversationReadRequest, AwikiPage, AwikiPageRequest, AwikiRegistrationOtpRequest, AwikiRegistrationOtpResult, AwikiRegistrationRequest, AwikiResolvePeerRequest, AwikiResolvedPeer, AwikiResult, AwikiRuntimeConfig, AwikiSession, AwikiSendAttachmentRequest, AwikiSendTextRequest, AwikiSummarizeConversationRequest, AwikiUpdateDisplayNameRequest } from './types.ts';
+import type { AwikiClientFactory } from './provider-api.ts';
+import type { AwikiSummaryProvider } from './summary-provider-api.ts';
+export type * from './types.ts';
+export { AWIKI_CLEAR_LOCAL_DATA_CONFIRMATION, AWIKI_LOGOUT_CONFIRMATION } from './types.ts';
+export type { AwikiClientFactory, AwikiClientOptions, AwikiSdkClient } from './provider-api.ts';
+export type { AwikiSummaryProvider, AwikiSummaryProviderRequest, AwikiSummaryProviderResult, AwikiSummarySourceMessage, } from './summary-provider-api.ts';
+export { AWIKI_DOMAIN_FIELD, AWIKI_SETTINGS_NAMESPACE, AwikiSettingsSchema, DEFAULT_AWIKI_DOMAIN, normalizeAwikiDomain, validateAwikiSettings, type AwikiSettings, } from './settings.ts';
+export { AWIKI_HISTORY_TOOL, AWIKI_IDENTITY_STATUS_TOOL, AWIKI_LIST_CONVERSATIONS_TOOL, AWIKI_SEND_ATTACHMENT_TOOL, AWIKI_SEND_MESSAGE_TOOL, } from './tools.ts';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        awiki: AwikiService;
+    }
+}
+/** Default maximum attachment size: 10 MiB. */
+export declare const DEFAULT_ATTACHMENT_MAX_BYTES: number;
+/** Default browser polling interval while the AWiki drawer is open. */
+export declare const DEFAULT_POLL_INTERVAL_MS = 3000;
+/** Default AWiki production service origin. */
+export declare const DEFAULT_AWIKI_SERVICE_URL = "https://awiki.ai";
+/** Default authoritative AWiki message-service DID. */
+export declare const DEFAULT_AWIKI_MESSAGE_SERVICE_DID = "did:wba:awiki.ai";
+/** Host-owned model input cap after message minimization. */
+export declare const DEFAULT_SUMMARY_MAX_INPUT_BYTES: number;
+/** Hard limit for one user-triggered conversation summary. */
+export declare const MAX_SUMMARY_MESSAGES = 50;
+/** Host deployment configuration. */
+export interface Config {
+    /** AWiki user-service base URL. Production deployments require HTTPS. */
+    readonly userServiceUrl?: string;
+    /** Handle provider domain used by Legacy registration. */
+    readonly userServiceDomain?: string;
+    /** AWiki message-service base URL. Production deployments require HTTPS. */
+    readonly messageServiceUrl?: string;
+    /** Public message-service base URL published in the identity DID document. */
+    readonly messageServicePublicUrl?: string;
+    /** Authoritative DID of the configured message service. */
+    readonly messageServiceDid?: string;
+    /** Exact HTTPS origins allowed for discovered attachment object URLs. Defaults to the public message-service origin. */
+    readonly allowedAttachmentOrigins?: string[];
+    /** Permit loopback HTTP only for local tests. Defaults to false. */
+    readonly allowInsecureLoopbackForTesting?: boolean;
+    /** Rust IM Core root for identity, SQLite, cache, and compatibility state. */
+    readonly stateRoot?: string;
+    /** Complete decoded attachment byte limit. Defaults to 10 MiB. */
+    readonly attachmentMaxBytes?: number;
+    /** Browser history polling interval while its drawer is open. Defaults to 3000 ms. */
+    readonly pollIntervalMs?: number;
+    /** Maximum UTF-8 bytes of minimized message JSON sent to a summary provider. */
+    readonly summaryMaxInputBytes?: number;
+}
+/** Loader schema for the Host deployment configuration. */
+export declare const Config: z<Config>;
+/** Deployment-wide AWiki service over one replaceable high-level client provider. */
+export declare class AwikiService extends TypertRemoteService implements AwikiHostClient {
+    static inject: string[];
+    static Config: z<Config>;
+    private readonly resolved;
+    private readonly sessionStore;
+    private startupUserServiceDomain;
+    private settingsProvider;
+    private provider;
+    private signedOut;
+    private sessionMutation;
+    private sessionRevision;
+    private readonly activeSummaryRequests;
+    private summaryProvider;
+    /**
+     * @param ctx - owning Host context.
+     * @param config - service endpoints, SDK state path, and public limits.
+     */
+    constructor(ctx: Context, config: Config);
+    /**
+     * Register the deployment's sole client factory. The caller must return the
+     * resulting disposer from its own `ctx.effect`; disposal clears the slot
+     * before awaiting the client's quiescence and is idempotent.
+     * @param factory - synchronous factory for one owned high-level client.
+     * @returns asynchronous disposer for the exact registered client.
+     */
+    registerClientFactory(factory: AwikiClientFactory): () => Promise<void>;
+    /** Register one replaceable conversation-summary provider for this deployment. */
+    registerSummaryProvider(provider: AwikiSummaryProvider): () => void;
+    /**
+     * Read settings needed by the browser presentation.
+     * @returns Browser-safe polling configuration without SDK endpoints or state paths.
+     */
+    getConfig(): Promise<AwikiResult<AwikiRuntimeConfig>>;
+    /**
+     * Read the deployment's identity status.
+     * @returns The public deployment identity or `null`.
+     */
+    getIdentity(): Promise<AwikiResult<AwikiIdentity | null>>;
+    /** Return the local registration and sign-in state without exposing secrets. */
+    getSession(): Promise<AwikiResult<AwikiSession>>;
+    /** Lock this installation while preserving the encrypted identity and local database. */
+    logout(request: AwikiLogoutRequest): Promise<AwikiResult<AwikiSession>>;
+    /** Resume the same locally preserved identity without registration. */
+    login(): Promise<AwikiResult<AwikiSession>>;
+    /**
+     * Send one Legacy registration verification code.
+     * @param request - Handle and phone used for the registration challenge.
+     * @returns Public retry timing or a closed failure.
+     */
+    sendRegistrationOtp(request: AwikiRegistrationOtpRequest): Promise<AwikiResult<AwikiRegistrationOtpResult>>;
+    /**
+     * Register and persist the deployment's only AWiki identity.
+     * @param request - Handle, phone, and verification code for registration.
+     * @returns The new public identity or a closed failure.
+     */
+    registerIdentity(request: AwikiRegistrationRequest): Promise<AwikiResult<AwikiIdentity>>;
+    /**
+     * Update the deployment identity's public WNS display name.
+     * @param request - replacement display name selected by the user.
+     * @returns The updated public identity or a closed failure.
+     */
+    updateDisplayName(request: AwikiUpdateDisplayNameRequest): Promise<AwikiResult<AwikiIdentity>>;
+    /**
+     * Resolve one Handle or DID before the browser opens a direct chat.
+     * @param request - typed Handle or DID.
+     * @returns The public peer and conversation id, or a closed failure.
+     */
+    resolvePeer(request: AwikiResolvePeerRequest): Promise<AwikiResult<AwikiResolvedPeer>>;
+    /**
+     * List direct and existing group conversations.
+     * @param request - Optional opaque cursor and page limit.
+     * @returns One page of direct and existing group conversations.
+     */
+    listConversations(request?: AwikiPageRequest): Promise<AwikiResult<AwikiPage<AwikiConversation>>>;
+    /**
+     * Read one direct or group conversation history page.
+     * @param request - Conversation id, optional cursor, and page limit.
+     * @returns One chronological history page.
+     */
+    getHistory(request: AwikiHistoryRequest): Promise<AwikiResult<AwikiPage<AwikiMessage>>>;
+    /**
+     * Read real AWiki history, enforce range and byte caps, then invoke the configured model once.
+     * @param request - selected conversation and its unread snapshot at open time.
+     * @returns a structured summary plus the exact summarized source range.
+     */
+    summarizeConversation(request: AwikiSummarizeConversationRequest): Promise<AwikiResult<AwikiConversationSummary>>;
+    /**
+     * Mark every currently unread inbox message in one conversation as read.
+     * @param request - conversation whose current inbox entries should be acknowledged.
+     * @returns Number of inbox entries acknowledged by the Message Service.
+     */
+    markConversationRead(request: AwikiMarkConversationReadRequest): Promise<AwikiResult<number>>;
+    /**
+     * Send one text message through the deployment identity.
+     * @param request - Target, text, and idempotency key.
+     * @returns The accepted public message or a closed failure.
+     */
+    sendText(request: AwikiSendTextRequest): Promise<AwikiResult<AwikiMessage>>;
+    /**
+     * Upload and send one attachment after Host validation.
+     * @param request - Target, attachment metadata and Base64 bytes, caption, and idempotency key.
+     * @returns The accepted attachment message or a closed failure.
+     */
+    sendAttachment(request: AwikiSendAttachmentRequest): Promise<AwikiResult<AwikiMessage>>;
+    /**
+     * Download and encode one provider-verified attachment.
+     * @param request - Containing message id and attachment id.
+     * @returns Verified public metadata and canonical Base64 bytes, or a closed failure.
+     */
+    downloadAttachment(request: AwikiDownloadAttachmentRequest): Promise<AwikiResult<AwikiDownloadedAttachment>>;
+    /**
+     * Permanently remove the exact SDK-owned local state after an explicit browser acknowledgement.
+     * The remote AWiki account and Handle are not deleted.
+     * @param request - exact destructive-action marker emitted only after the UI's second confirmation.
+     * @returns Whether a persisted state file existed when the reset completed.
+     */
+    clearLocalData(request: AwikiClearLocalDataRequest): Promise<AwikiResult<AwikiClearLocalDataResult>>;
+    /** Invalidate cached session work and cancel every model request still owned by the old session. */
+    private invalidateSummaries;
+    /** Invoke the current client and normalize every rejection to a public result. */
+    private run;
+    /** Read and cache the private Host-owned session marker. */
+    private isSignedOut;
+    /** Serialize sign-in, sign-out, and destructive clear transitions. */
+    private mutateSession;
+    /** Clear one exact provider slot before joining its one shared disposal. */
+    private disposeProvider;
+}
+export default AwikiService;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}