@qlever-llc/trellis 0.7.0 → 0.8.0-rc.3

package/script/npm/src/client_connect.d.ts

@@ -0,0 +1,71 @@
+import { CONTRACT_STATE_METADATA, type ContractStateMetadata } from "./contract_support/mod.js";
+import type { ClientOpts } from "./client.js";
+import type { TrellisAPI, TrellisContractV1 } from "./contracts.js";
+import { type RuntimeTransport } from "./runtime_transport.js";
+import { type ConnectedTrellisClient, type RuntimeStateStores, Trellis } from "./trellis.js";
+import { TransportError } from "./errors/index.js";
+import { AsyncResult, UnexpectedError } from "@qlever-llc/result";
+import { type SessionKeyHandle } from "./auth/browser/session.js";
+type ClientContract<TApi extends TrellisAPI = TrellisAPI, TContract extends TrellisContractV1 = TrellisContractV1> = {
+    CONTRACT: TContract;
+    CONTRACT_DIGEST?: string;
+    API: {
+        trellis: TApi;
+    };
+    readonly [CONTRACT_STATE_METADATA]?: ContractStateMetadata;
+};
+type BrowserClientAuthOptions = {
+    mode?: "browser";
+    handle?: SessionKeyHandle;
+    provider?: string;
+    redirectTo?: string | (() => string);
+    landingPath?: string;
+    context?: unknown;
+    currentUrl?: URL | string | (() => URL | string);
+    flowId?: string;
+};
+type SessionKeyClientAuthOptions = {
+    mode: "session_key";
+    sessionKeySeed: string;
+    provider?: string;
+    redirectTo: string;
+    context?: unknown;
+    flowId?: string;
+};
+export type ClientAuthOptions = BrowserClientAuthOptions | SessionKeyClientAuthOptions;
+export type ClientAuthRequiredContext = {
+    loginUrl: string;
+    sessionKey: string;
+    mode: "browser" | "session_key";
+};
+export type ClientAuthContinuation = {
+    status: "bound";
+    flowId: string;
+} | {
+    status: "handled";
+} | void;
+/**
+ * Error raised when client authentication was delegated to caller-owned routing.
+ */
+export declare class ClientAuthHandledError extends Error {
+    constructor();
+}
+type ClientConnectArgsFor<TContract extends ClientContract> = ClientOpts & {
+    trellisUrl: string;
+    contract: TContract;
+    auth?: ClientAuthOptions;
+    onAuthRequired?: (ctx: ClientAuthRequiredContext) => Promise<ClientAuthContinuation> | ClientAuthContinuation;
+};
+export type TrellisClientConnectArgs<TApi extends TrellisAPI = TrellisAPI, TContract extends ClientContract<TApi, TrellisContractV1> = ClientContract<TApi, TrellisContractV1>> = ClientConnectArgsFor<TContract>;
+type ClientConnectDeps = {
+    loadTransport(): Promise<RuntimeTransport>;
+    now(): number;
+    setInterval?: (handler: () => void, ms: number) => ReturnType<typeof globalThis.setInterval>;
+    clearInterval?: (id: ReturnType<typeof globalThis.setInterval>) => void;
+};
+export declare function connectClientWithDeps<TContract extends ClientContract<TrellisAPI, TrellisContractV1>>(args: ClientConnectArgsFor<TContract>, deps: ClientConnectDeps): Promise<Trellis<TrellisAPI, "client", RuntimeStateStores>>;
+export declare class TrellisClient {
+    static connect<TContract extends ClientContract<TrellisAPI, TrellisContractV1>>(args: ClientConnectArgsFor<TContract>): AsyncResult<ConnectedTrellisClient<TContract>, TransportError | UnexpectedError>;
+}
+export {};
+//# sourceMappingURL=client_connect.d.ts.map

package/script/npm/src/client_connect.d.ts.map

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