@theaiplatform/miniapp-sdk 0.0.0 → 0.0.2

package/dist/sdk.d.ts

@@ -99,7 +99,7 @@ export declare type MiniAppAuthApi = {
 };
 
 /**
- * @capability integrations-and-marketplace
+ * @capability miniapp-platform
  */
 export declare type MiniAppChannel = {
     roomId: string;
@@ -143,6 +143,85 @@ export declare type MiniAppCreateSpecialistResult = {
     isActive: boolean;
 };
 
+/** Metadata-only access to host-managed credentials in the active workspace. */
+export declare type MiniAppCredentialsApi = {
+    listHttp(): MiniAppMaybePromise<MiniAppHttpCredentialMetadata[]>;
+};
+
+/** Host-mediated bounded HTTP(S); browser fetch is not the authority. */
+export declare type MiniAppHttpApi = {
+    request(input: MiniAppHttpRequestInput, options?: MiniAppHttpRequestOptions): MiniAppMaybePromise<MiniAppHttpResponse>;
+};
+
+/** Metadata-only stored HTTP credential. Secret fields never cross IPC. */
+export declare type MiniAppHttpCredentialMetadata = {
+    id: string;
+    credentialType: MiniAppHttpCredentialType;
+    displayName: string;
+    metadataFields: Record<string, string>;
+};
+
+export declare type MiniAppHttpCredentialType = 'http_bearer' | 'http_basic' | 'http_header_auth' | 'http_api_key';
+
+export declare type MiniAppHttpHeader = {
+    name: string;
+    value: string;
+};
+
+export declare type MiniAppHttpHeaderInput = {
+    name: string;
+    value: string;
+    /** Defaults to true when omitted. */
+    enabled?: boolean;
+};
+
+export declare type MiniAppHttpQueryInput = {
+    name: string;
+    value: string;
+    /** Defaults to true when omitted. */
+    enabled?: boolean;
+};
+
+export declare type MiniAppHttpRequestInput = {
+    method: string;
+    url: string;
+    query?: MiniAppHttpQueryInput[];
+    headers?: MiniAppHttpHeaderInput[];
+    body?: string | null;
+    /** Defaults to 30 seconds and is capped by the host at 120 seconds. */
+    timeoutMs?: number | null;
+    /** Defaults to 5 MiB and is capped by the host at 10 MiB. */
+    responseBodyLimitBytes?: number | null;
+    /**
+     * Defaults to false. The host follows at most ten same-origin redirects;
+     * cross-origin redirects require a separate request and grant.
+     */
+    followRedirects?: boolean | null;
+};
+
+export declare type MiniAppHttpRequestOptions = {
+    /**
+     * Opaque host-managed credential reference. Secret material never enters
+     * miniapp JavaScript.
+     */
+    credentialRef?: string;
+};
+
+export declare type MiniAppHttpResponse = {
+    finalUrl: string;
+    status: number;
+    statusText: string;
+    /** Ordered entries; duplicate response header names remain separate. */
+    headers: MiniAppHttpHeader[];
+    bodyText: string | null;
+    bodyBase64: string | null;
+    bodyKind: 'text' | 'binary';
+    bodyTruncated: boolean;
+    sizeBytes: number;
+    elapsedMs: number;
+    contentType: string | null;
+};
+
 /** JSON-compatible values accepted by public miniapp operations. */
 export declare type MiniAppJsonValue = null | boolean | number | string | MiniAppJsonValue[] | {
     [key: string]: MiniAppJsonValue;
@@ -234,6 +313,12 @@ export declare type MiniAppPlatformApi = {
         open(options: OpenNavigationOptions): void | Promise<void>;
     };
     chat: MiniAppChatApi;
+    storage: MiniAppStorageApi;
+    presence: MiniAppPresenceApi;
+    /** Desktop host capability; feature-detect before use on portable targets. */
+    http?: MiniAppHttpApi;
+    /** Desktop host capability; feature-detect before use on portable targets. */
+    credentials?: MiniAppCredentialsApi;
     /** Browser capabilities appear only when the selected target supports them. */
     auth?: MiniAppAuthApi;
     vfs?: MiniAppVfsApi;
@@ -242,6 +327,41 @@ export declare type MiniAppPlatformApi = {
     hasHostHttpRequest?: boolean;
 };
 
+export declare type MiniAppPresenceAddress = {
+    namespace: string;
+    room: string;
+};
+
+/**
+ * Ephemeral realtime presence scoped by the host to the active workspace and
+ * exact package. Participant identity is stamped by the host, not the app.
+ */
+export declare type MiniAppPresenceApi = {
+    join(options: MiniAppPresenceUpdateOptions): MiniAppMaybePromise<MiniAppPresenceSnapshot>;
+    update(options: MiniAppPresenceUpdateOptions): MiniAppMaybePromise<MiniAppPresenceSnapshot>;
+    leave(options: MiniAppPresenceAddress): MiniAppMaybePromise<void>;
+    subscribe(options: MiniAppPresenceAddress, listener: MiniAppPresenceListener): () => void;
+};
+
+export declare type MiniAppPresenceListener = (snapshot: MiniAppPresenceSnapshot) => void;
+
+export declare type MiniAppPresenceParticipant = {
+    /** Host-derived, ephemeral participant identity. */
+    participantId: string;
+    displayName: string;
+    state: MiniAppJsonValue;
+    updatedAtMs: number;
+};
+
+export declare type MiniAppPresenceSnapshot = MiniAppPresenceAddress & {
+    selfParticipantId: string;
+    participants: MiniAppPresenceParticipant[];
+};
+
+export declare type MiniAppPresenceUpdateOptions = MiniAppPresenceAddress & {
+    state: MiniAppJsonValue;
+};
+
 export declare type MiniAppProject = {
     id: string;
     name: string;
@@ -341,6 +461,43 @@ export declare type MiniAppSpecialistTurnResult = {
     };
 };
 
+/** Caller-selected partition inside the host-derived workspace/package scope. */
+export declare type MiniAppStorageAddress = {
+    namespace: string;
+    key: string;
+};
+
+/**
+ * Durable, non-secret JSON storage. The host derives workspace and package
+ * identity from the authenticated frame; apps control only the namespace and
+ * key inside that scope.
+ */
+export declare type MiniAppStorageApi = {
+    get(options: MiniAppStorageAddress): MiniAppMaybePromise<MiniAppStorageEntry>;
+    set(options: MiniAppStorageSetOptions): MiniAppMaybePromise<MiniAppStorageMutationResult>;
+    delete(options: MiniAppStorageDeleteOptions): MiniAppMaybePromise<void>;
+};
+
+export declare type MiniAppStorageDeleteOptions = MiniAppStorageAddress & {
+    expectedRevision: number;
+};
+
+export declare type MiniAppStorageEntry = {
+    value: MiniAppJsonValue | null;
+    /** Null means that no value currently exists at this address. */
+    revision: number | null;
+};
+
+export declare type MiniAppStorageMutationResult = {
+    revision: number;
+};
+
+export declare type MiniAppStorageSetOptions = MiniAppStorageAddress & {
+    value: MiniAppJsonValue;
+    /** Optimistic concurrency token returned by `get`; null creates a missing key. */
+    expectedRevision: number | null;
+};
+
 export declare type MiniAppUserProfile = {
     sub: string;
     name?: string | null;

package/dist/surface.d.ts

@@ -38,7 +38,7 @@ export declare interface TapFederatedSurfaceMountContext {
 }
 
 /**
- * @capability integrations-and-marketplace
+ * @capability miniapp-platform
  */
 /** Declared package-event channel supplied to an isolated UI contribution. */
 export declare interface TapPackageEventPublisher {