@kumwe/studio-core 0.1.0-alpha.7 → 0.1.0-rc.1

package/dist/host-session.d.ts

@@ -0,0 +1,74 @@
+import { type ArtifactReference, type ContentModelDocument, type HostAdapter, type HostPortResult, type JsonObject, type QualifiedName, type ResourceSearchPage, type ResourceSearchQuery, type Revision, type StableId, type StudioConfiguration, type StudioDiagnostic } from '@kumwe/studio-protocol';
+import { type CapabilityNegotiationResult } from './negotiation.js';
+import { StudioSession } from './session.js';
+/** Public bounds enforced before a composed session invokes resource search. */
+export declare const STUDIO_RESOURCE_SEARCH_LIMITS: Readonly<{
+    maximumCursorLength: number;
+    maximumLimit: number;
+    maximumSearchLength: number;
+    minimumLimit: number;
+}>;
+export interface StudioHostSessionIdentifierFactories {
+    /** Allocates a session-unique request identifier for one host attempt. */
+    requestId(operationId: QualifiedName): StableId;
+    /** Allocates a mutation identifier; exact failed-intent retries reuse it. */
+    idempotencyKey(operationId: QualifiedName): StableId;
+}
+export interface OpenStudioSessionOptions {
+    /** A schema-valid, resolved, immutable configuration supplied by the host. */
+    configuration: StudioConfiguration;
+    /** Injected so core never depends on clocks, randomness, DOM, or Node APIs. */
+    identifiers: StudioHostSessionIdentifierFactories;
+    /** Additional port capabilities whose absence should be diagnosed as degradation. */
+    optionalPorts?: readonly QualifiedName[];
+}
+export interface StudioHostSessionRecovery {
+    discard(): Promise<HostPortResult<null>>;
+    load(): Promise<HostPortResult<JsonObject | null>>;
+    store(envelope: JsonObject): Promise<HostPortResult<null>>;
+}
+/** Read-only access to the authorized model projection behind this session. */
+export interface StudioHostSessionModels {
+    get(reference: ArtifactReference): Promise<HostPortResult<ContentModelDocument>>;
+    list(): Promise<HostPortResult<ContentModelDocument[]>>;
+}
+/** Read-only discovery of host-authorized resources behind this session. */
+export interface StudioHostSessionResources {
+    search(query: ResourceSearchQuery): Promise<HostPortResult<ResourceSearchPage>>;
+}
+export interface StudioHostSessionHandle {
+    /** The complete open-time negotiation and profile diagnostics. */
+    readonly diagnostics: readonly StudioDiagnostic[];
+    readonly disposed: boolean;
+    readonly invalidated: boolean;
+    readonly negotiation: CapabilityNegotiationResult;
+    /** Present only when the model port advertises and implements both read operations. */
+    readonly models: StudioHostSessionModels | undefined;
+    /** Present only when feature policy, advertised operations, and adapter agree. */
+    readonly recovery: StudioHostSessionRecovery | undefined;
+    /** Present only when the resource port advertises and implements search. */
+    readonly resources: StudioHostSessionResources | undefined;
+    /** The most recent host-accepted Blueprint revision. */
+    readonly revision: Revision;
+    readonly session: StudioSession;
+    /** Local, idempotent teardown. It never invents a host teardown operation. */
+    dispose(): void;
+    save(): Promise<HostPortResult<null>>;
+}
+export type StudioHostSessionErrorCode = 'configuration-blocked' | 'disposed' | 'invalid-identifier' | 'invalid-model-reference' | 'invalid-resource-query' | 'read-only-session' | 'unexpected-artifact';
+/** A local composition/state failure, distinct from a host-port rejection. */
+export declare class StudioHostSessionError extends Error {
+    readonly code: StudioHostSessionErrorCode;
+    readonly diagnostics: readonly StudioDiagnostic[];
+    constructor(code: StudioHostSessionErrorCode, message: string, diagnostics?: readonly StudioDiagnostic[]);
+}
+/**
+ * Composes the DOM-free editing engine with one resolved host configuration.
+ *
+ * The current contract-safe profile opens a single Blueprint only. It does
+ * not fabricate entry/model state, infer a transport, stage preview drafts,
+ * or reconcile recovery data. Those capabilities require their own explicit
+ * contracts.
+ */
+export declare function openStudioSession(adapter: HostAdapter, options: Readonly<OpenStudioSessionOptions>): Promise<StudioHostSessionHandle>;
+//# sourceMappingURL=host-session.d.ts.map

package/dist/host-session.d.ts.map

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