@theaiplatform/miniapp-sdk 0.3.2 → 0.4.0

package/dist/index.d.ts

@@ -124,6 +124,29 @@ export declare type MiniAppAuthApi = {
     getUserProfile(): MiniAppMaybePromise<MiniAppUserProfile | null>;
 };
 
+/**
+ * Read-only authorization introspection for custom surface behavior.
+ *
+ * The host rejects action IDs that are not declared by the exact mounted
+ * surface. A declared action resolves to the current dynamic allow/deny
+ * decision without executing the action.
+ */
+export declare type MiniAppAuthorizationApi = {
+    check(options: MiniAppAuthorizationCheckOptions): Promise<MiniAppAuthorizationCheckResult>;
+};
+
+/** Canonical autonomy requested for one descriptor-declared package action. */
+export declare type MiniAppAuthorizationAutonomy = 'listen' | 'plan' | 'do';
+
+export declare type MiniAppAuthorizationCheckOptions = {
+    actionId: string;
+    autonomy: MiniAppAuthorizationAutonomy;
+};
+
+export declare type MiniAppAuthorizationCheckResult = {
+    allowed: boolean;
+};
+
 /** Closed discovery taxonomy accepted by `presentation.categories`. */
 export declare type MiniAppCategory = 'productivity' | 'developer-tools' | 'creativity' | 'communication' | 'data-and-analytics' | 'business' | 'education' | 'media-and-entertainment' | 'utilities' | 'other';
 
@@ -346,8 +369,10 @@ export declare type MiniAppPlatformApi = {
     navigation: {
         open(options: OpenNavigationOptions): void | Promise<void>;
     };
+    authorization: MiniAppAuthorizationApi;
     chat: MiniAppChatApi;
     storage: MiniAppStorageApi;
+    session: MiniAppSessionApi;
     presence: MiniAppPresenceApi;
     /** Desktop host capability; feature-detect before use on portable targets. */
     http?: MiniAppHttpApi;
@@ -507,6 +532,31 @@ export declare type MiniAppReceiptTextAlignment = 'left' | 'center' | 'right';
 
 export declare type MiniAppReceiptTextWeight = 'normal' | 'bold';
 
+/**
+ * Secure session storage backed by the operating system credential store.
+ *
+ * The host derives the signed-in TAP account, active workspace, installation,
+ * and package from the authenticated frame. Channel, surface, document, and
+ * release are deliberately excluded, so every surface of one installed
+ * miniapp shares the same session only within a workspace and package updates
+ * retain it. Unlike host-managed HTTP credentials, values returned here enter
+ * miniapp JavaScript.
+ */
+export declare type MiniAppSessionApi = {
+    get(): MiniAppMaybePromise<MiniAppSessionEntry>;
+    set(value: MiniAppSessionValue): MiniAppMaybePromise<void>;
+    clear(): MiniAppMaybePromise<void>;
+};
+
+export declare type MiniAppSessionEntry = {
+    /** Null means that no session value currently exists for this installation. */
+    value: MiniAppSessionValue | null;
+};
+
+export declare type MiniAppSessionValue = {
+    [key: string]: MiniAppJsonValue;
+};
+
 export declare type MiniAppSpecialistApi = {
     joinToChannel(channelId: string, specialistId: string): MiniAppMaybePromise<string>;
     listWorkspace(workspaceId: string): MiniAppMaybePromise<MiniAppSpecialistSummary[]>;

package/dist/internal/json-schema.d.ts

@@ -0,0 +1,10 @@
+import type { Format } from 'ajv';
+
+/** Register the canonical JSON Schema formats shared by TAP package tooling. */
+export declare function registerTapManifestAjvFormats<Registry extends TapJsonSchemaFormatRegistry>(ajv: Registry): Registry;
+
+export declare interface TapJsonSchemaFormatRegistry {
+    addFormat(name: string, format: Format): unknown;
+}
+
+export { }

package/dist/internal/json-schema.js

@@ -0,0 +1,53 @@
+function isUrl(value) {
+    try {
+        new URL(value);
+        return true;
+    } catch  {
+        return false;
+    }
+}
+function isDateTime(value) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(?:Z|([+-])(\d{2}):(\d{2}))$/u.exec(value);
+    if (!match) return false;
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const hour = Number(match[4]);
+    const minute = Number(match[5]);
+    const second = Number(match[6]);
+    const offsetHour = void 0 === match[8] ? 0 : Number(match[8]);
+    const offsetMinute = void 0 === match[9] ? 0 : Number(match[9]);
+    if (month < 1 || month > 12 || hour > 23 || minute > 59 || second > 59 || offsetHour > 23 || offsetMinute > 59) return false;
+    const calendar = new Date(0);
+    calendar.setUTCHours(hour, minute, second, 0);
+    calendar.setUTCFullYear(year, month - 1, day);
+    return calendar.getUTCFullYear() === year && calendar.getUTCMonth() === month - 1 && calendar.getUTCDate() === day;
+}
+function registerTapManifestAjvFormats(ajv) {
+    ajv.addFormat('uri', {
+        type: 'string',
+        validate: isUrl
+    });
+    ajv.addFormat('uint8', {
+        type: 'number',
+        validate: (value)=>Number.isInteger(value) && value >= 0 && value <= 255
+    });
+    ajv.addFormat('uint16', {
+        type: 'number',
+        validate: (value)=>Number.isInteger(value) && value >= 0 && value <= 65535
+    });
+    ajv.addFormat('uint32', {
+        type: 'number',
+        validate: (value)=>Number.isInteger(value) && value >= 0 && value <= 4294967295
+    });
+    ajv.addFormat('uint64', {
+        type: 'number',
+        validate: (value)=>Number.isSafeInteger(value) && value >= 0
+    });
+    ajv.addFormat('date-time', {
+        type: 'string',
+        validate: isDateTime
+    });
+    return ajv;
+}
+export { registerTapManifestAjvFormats };

package/dist/rspack/index.d.ts

@@ -1,5 +1,4 @@
 import type { Format } from 'ajv';
-import type { LibConfig } from '@rslib/core';
 import { ModuleFederationOptions } from '@module-federation/rsbuild-plugin';
 import { RsbuildPlugin } from '@rsbuild/core';
 
@@ -30,15 +29,42 @@ declare type Config = {
 
 export declare const pluginTap: (options?: Config) => RsbuildPlugin;
 
-/** Registers the canonical JSON Schema formats used by TAP manifests. */
-export declare const registerTapManifestAjvFormats: <Registry extends TapManifestAjvFormatRegistry>(ajv: Registry) => Registry;
+/** Register the canonical JSON Schema formats shared by TAP package tooling. */
+export declare function registerTapManifestAjvFormats<Registry extends TapJsonSchemaFormatRegistry>(ajv: Registry): Registry;
 
-export declare const tapLib: (options?: Config) => LibConfig;
-
-declare interface TapManifestAjvFormatRegistry {
+declare interface TapJsonSchemaFormatRegistry {
     addFormat(name: string, format: Format): unknown;
 }
 
+export declare const tapLib: (options?: Config) => TapLibConfig;
+
+/**
+ * Patch-stable Rslib configuration returned by {@link tapLib}.
+ *
+ * Rslib and Rspack config types contain dependency-private symbols. Publishing
+ * those concrete types makes a linked SDK incompatible with a consumer using a
+ * different compatible patch release. Keep the extension sections mutable and
+ * structurally open while retaining the stable scalar contract owned by TAP.
+ */
+export declare type TapLibConfig = {
+    format: 'mf' | 'esm';
+    bundle: true;
+    autoExternal: false;
+    dts: false;
+    source?: Record<string, any>;
+    output: Record<string, any>;
+    tools: {
+        rspack?: TapRspackTool;
+        [key: string]: any;
+    };
+    plugins: Array<{
+        name: string;
+        apply?: any;
+        setup: (api: any) => void | Promise<void>;
+        [key: string]: any;
+    }>;
+};
+
 /** Emitted-package scan used to reject machine-local build artifacts. */
 export declare type TapPackageArtifactPortabilityOptions = {
     output: string;
@@ -58,4 +84,44 @@ export declare type TapPackageAssemblyOptions = {
 
 export declare type TapPackageTarget = NonNullable<Config['packageTarget']>;
 
+export declare type TapRspackConfig = {
+    plugins?: any[];
+    module?: {
+        rules?: any[];
+        [key: string]: any;
+    };
+    resolve?: {
+        alias?: false | Record<string, string | false | Array<string | false>>;
+        [key: string]: any;
+    };
+    output?: Record<string, any>;
+    [key: string]: any;
+};
+
+export declare type TapRspackConfigMutator = (config: TapRspackNormalizedConfig, context: any) => void | TapRspackConfig | Promise<void | TapRspackConfig>;
+
+/**
+ * Patch-stable subset of the normalized Rspack configuration supplied to
+ * `tools.rspack` callbacks.
+ *
+ * The real Rspack declarations contain dependency-private symbols, so this
+ * deliberately keeps extension values open while preserving contextual types
+ * for the configuration seams miniapps commonly customize.
+ */
+export declare type TapRspackNormalizedConfig = {
+    plugins: any[];
+    module: {
+        rules?: any[];
+        [key: string]: any;
+    };
+    resolve: {
+        alias?: false | Record<string, string | false | Array<string | false>>;
+        [key: string]: any;
+    };
+    output: Record<string, any>;
+    [key: string]: any;
+};
+
+export declare type TapRspackTool = TapRspackConfig | TapRspackConfigMutator | Array<TapRspackConfig | TapRspackConfigMutator>;
+
 export { }