@peerllm/client-core 0.1.0

package/dist/services/orchestrations/connections/ConnectionOrchestrationService.Exceptions.js

@@ -0,0 +1,41 @@
+import { ConfigProcessingDependencyException } from "../../../models/processings/configs/exceptions/ConfigProcessingDependencyException.js";
+import { ConfigProcessingDependencyValidationException } from "../../../models/processings/configs/exceptions/ConfigProcessingDependencyValidationException.js";
+import { ConfigProcessingValidationException } from "../../../models/processings/configs/exceptions/ConfigProcessingValidationException.js";
+import { SecretProcessingDependencyException } from "../../../models/processings/secrets/exceptions/SecretProcessingDependencyException.js";
+import { SecretProcessingDependencyValidationException } from "../../../models/processings/secrets/exceptions/SecretProcessingDependencyValidationException.js";
+import { SecretProcessingValidationException } from "../../../models/processings/secrets/exceptions/SecretProcessingValidationException.js";
+import { ConnectionDependencyException } from "../../../models/orchestrations/connections/exceptions/ConnectionDependencyException.js";
+import { ConnectionDependencyValidationException } from "../../../models/orchestrations/connections/exceptions/ConnectionDependencyValidationException.js";
+import { ConnectionServiceException } from "../../../models/orchestrations/connections/exceptions/ConnectionServiceException.js";
+import { ConnectionValidationException } from "../../../models/orchestrations/connections/exceptions/ConnectionValidationException.js";
+import { FailedConnectionServiceException } from "../../../models/orchestrations/connections/exceptions/FailedConnectionServiceException.js";
+import { NoConnectionException } from "../../../models/orchestrations/connections/exceptions/NoConnectionException.js";
+export function createTryCatch(loggingBroker) {
+    return async function tryCatch(routine) {
+        try {
+            return await routine();
+        }
+        catch (error) {
+            if (error instanceof NoConnectionException) {
+                throw await createAndLog(loggingBroker, new ConnectionValidationException("Connection validation error occurred, fix the error and try again.", error));
+            }
+            if (error instanceof ConfigProcessingValidationException || error instanceof SecretProcessingValidationException) {
+                throw await createAndLog(loggingBroker, new ConnectionValidationException("Connection validation error occurred, fix the error and try again.", error.innerError));
+            }
+            if (error instanceof ConfigProcessingDependencyValidationException ||
+                error instanceof SecretProcessingDependencyValidationException) {
+                throw await createAndLog(loggingBroker, new ConnectionDependencyValidationException("Connection dependency validation error occurred, fix the error and try again.", error.innerError));
+            }
+            if (error instanceof ConfigProcessingDependencyException || error instanceof SecretProcessingDependencyException) {
+                throw await createAndLog(loggingBroker, new ConnectionDependencyException("Connection dependency error occurred, contact support.", error.innerError));
+            }
+            const failed = new FailedConnectionServiceException("Failed connection service error occurred, contact support.", error instanceof Error ? error : new Error(String(error)));
+            throw await createAndLog(loggingBroker, new ConnectionServiceException("Connection service error occurred, contact support.", failed));
+        }
+    };
+}
+async function createAndLog(loggingBroker, exception) {
+    await loggingBroker.logError(exception);
+    return exception;
+}
+//# sourceMappingURL=ConnectionOrchestrationService.Exceptions.js.map

package/dist/services/orchestrations/connections/ConnectionOrchestrationService.Exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionOrchestrationService.Exceptions.js","sourceRoot":"","sources":["../../../../src/services/orchestrations/connections/ConnectionOrchestrationService.Exceptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mCAAmC,EAAE,MAAM,uFAAuF,CAAC;AAC5I,OAAO,EAAE,6CAA6C,EAAE,MAAM,iGAAiG,CAAC;AAChK,OAAO,EAAE,mCAAmC,EAAE,MAAM,uFAAuF,CAAC;AAC5I,OAAO,EAAE,mCAAmC,EAAE,MAAM,uFAAuF,CAAC;AAC5I,OAAO,EAAE,6CAA6C,EAAE,MAAM,iGAAiG,CAAC;AAChK,OAAO,EAAE,mCAAmC,EAAE,MAAM,uFAAuF,CAAC;AAC5I,OAAO,EAAE,6BAA6B,EAAE,MAAM,wFAAwF,CAAC;AACvI,OAAO,EAAE,uCAAuC,EAAE,MAAM,kGAAkG,CAAC;AAC3J,OAAO,EAAE,0BAA0B,EAAE,MAAM,qFAAqF,CAAC;AACjI,OAAO,EAAE,6BAA6B,EAAE,MAAM,wFAAwF,CAAC;AACvI,OAAO,EAAE,gCAAgC,EAAE,MAAM,2FAA2F,CAAC;AAC7I,OAAO,EAAE,qBAAqB,EAAE,MAAM,gFAAgF,CAAC;AAQvH,MAAM,UAAU,cAAc,CAAC,aAA4B;IACzD,OAAO,KAAK,UAAU,QAAQ,CAAI,OAAyB;QACzD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;gBAC3C,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,6BAA6B,CAAC,oEAAoE,EAAE,KAAK,CAAC,CAC/G,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,mCAAmC,IAAI,KAAK,YAAY,mCAAmC,EAAE,CAAC;gBACjH,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,6BAA6B,CAC/B,oEAAoE,EACpE,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,IACE,KAAK,YAAY,6CAA6C;gBAC9D,KAAK,YAAY,6CAA6C,EAC9D,CAAC;gBACD,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,uCAAuC,CACzC,+EAA+E,EAC/E,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,mCAAmC,IAAI,KAAK,YAAY,mCAAmC,EAAE,CAAC;gBACjH,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,6BAA6B,CAAC,wDAAwD,EAAE,KAAK,CAAC,UAAU,CAAC,CAC9G,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,gCAAgC,CACjD,4DAA4D,EAC5D,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;YAEF,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,0BAA0B,CAAC,qDAAqD,EAAE,MAAM,CAAC,CAC9F,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAkB,aAA4B,EAAE,SAAY;IACrF,MAAM,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAExC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/services/orchestrations/connections/ConnectionOrchestrationService.d.ts

@@ -0,0 +1,27 @@
+import type { LoggingBroker } from "@hassanhabib/standard-agents";
+import type { ConnectionProfile } from "../../../models/foundations/configs/ConfigDocument.js";
+import type { ResolvedConnection } from "../../../models/orchestrations/connections/ResolvedConnection.js";
+import type { AccountKey } from "../../../models/brokers/accounts/AccountKey.js";
+import type { TokenBalance } from "../../../models/brokers/accounts/TokenBalance.js";
+import type { SignedInAccount } from "../../../models/processings/accounts/SignedInAccount.js";
+import type { AccountProcessingService } from "../../processings/accounts/AccountProcessingService.js";
+import type { ConfigProcessingService } from "../../processings/configs/ConfigProcessingService.js";
+import type { SecretProcessingService } from "../../processings/secrets/SecretProcessingService.js";
+export declare class ConnectionOrchestrationService {
+    private readonly configProcessingService;
+    private readonly secretProcessingService;
+    private readonly accountProcessingService;
+    private readonly loggingBroker;
+    private readonly tryCatch;
+    constructor(configProcessingService: ConfigProcessingService, secretProcessingService: SecretProcessingService, accountProcessingService: AccountProcessingService, loggingBroker: LoggingBroker);
+    resolveConnection(configPath: string): Promise<ResolvedConnection>;
+    private readConfigOrRefuse;
+    addProfile(configPath: string, profile: ConnectionProfile, apiKey: string): Promise<void>;
+    signIn(configPath: string, email: string, password: string, profile: ConnectionProfile, keyName: string): Promise<SignedInAccount>;
+    retrieveKeys(profileId: string): Promise<readonly AccountKey[]>;
+    retrieveBalance(profileId: string): Promise<TokenBalance>;
+    private access;
+    signOut(configPath: string, profileId: string): Promise<boolean>;
+    private forget;
+}
+//# sourceMappingURL=ConnectionOrchestrationService.d.ts.map

package/dist/services/orchestrations/connections/ConnectionOrchestrationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionOrchestrationService.d.ts","sourceRoot":"","sources":["../../../../src/services/orchestrations/connections/ConnectionOrchestrationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAI/G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kEAAkE,CAAC;AAC3G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yDAAyD,CAAC;AAC/F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wDAAwD,CAAC;AACvG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AACpG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAOpG,qBAAa,8BAA8B;IACzC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA0B;IAClE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA0B;IAClE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA2B;IACpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAGlC,uBAAuB,EAAE,uBAAuB,EAChD,uBAAuB,EAAE,uBAAuB,EAChD,wBAAwB,EAAE,wBAAwB,EAClD,aAAa,EAAE,aAAa;IASvB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAqB3D,kBAAkB;IAkBzB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBzF,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,CAAC;IAYpB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;IAI/D,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAQlD,MAAM;IA0Bb,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YA6BzD,MAAM;CAcrB"}

package/dist/services/orchestrations/connections/ConnectionOrchestrationService.js

@@ -0,0 +1,155 @@
+import { NotFoundConfigException } from "../../../models/foundations/configs/exceptions/NotFoundConfigException.js";
+import { ConfigProcessingDependencyValidationException } from "../../../models/processings/configs/exceptions/ConfigProcessingDependencyValidationException.js";
+import { NoConnectionException } from "../../../models/orchestrations/connections/exceptions/NoConnectionException.js";
+import { createTryCatch } from "./ConnectionOrchestrationService.Exceptions.js";
+// The active profile and its key, together (SPEC.md 14.3).
+//
+// Two processings, which is what this tier is for: the document says which profile, the store says
+// what its key is, and neither of them can answer the question on its own.
+export class ConnectionOrchestrationService {
+    configProcessingService;
+    secretProcessingService;
+    accountProcessingService;
+    loggingBroker;
+    tryCatch;
+    constructor(configProcessingService, secretProcessingService, accountProcessingService, loggingBroker) {
+        this.configProcessingService = configProcessingService;
+        this.secretProcessingService = secretProcessingService;
+        this.accountProcessingService = accountProcessingService;
+        this.loggingBroker = loggingBroker;
+        this.tryCatch = createTryCatch(this.loggingBroker);
+    }
+    resolveConnection(configPath) {
+        return this.tryCatch(async () => {
+            const document = await this.readConfigOrRefuse(configPath);
+            const profile = activeProfileOf(document);
+            const apiKey = await this.secretProcessingService.retrieveApiKey(profile.id);
+            // No key for this profile is the same to the person at the terminal as no profile at all:
+            // they have not signed in. Saying which of the two it was helps nobody decide anything.
+            if (apiKey === null || apiKey.length === 0) {
+                throw new NoConnectionException(`no key is stored for the profile '${profile.id}'. Run peerllm init to sign in.`);
+            }
+            return { profileId: profile.id, apiUrl: profile.baseUrl, apiKey, model: profile.model };
+        });
+    }
+    // No document, no profile and no key are one answer, not three. All of them mean the person in
+    // front of the terminal has not signed in, and which of the three it was changes nothing they
+    // would do next.
+    async readConfigOrRefuse(configPath) {
+        try {
+            return await this.configProcessingService.retrieveConfig(configPath);
+        }
+        catch (error) {
+            if (error instanceof ConfigProcessingDependencyValidationException &&
+                error.innerError instanceof NotFoundConfigException) {
+                throw new NoConnectionException("there is no configuration yet. Run peerllm init to sign in.");
+            }
+            throw error;
+        }
+    }
+    // The key first, then the document. A key with no profile naming it is a few bytes nobody reads;
+    // a profile with no key is a run that fails at the first turn with a 401 nobody can explain.
+    // Neither order is atomic, so the order is chosen by which half is safer to be left holding.
+    addProfile(configPath, profile, apiKey) {
+        return this.tryCatch(async () => {
+            await this.secretProcessingService.upsertApiKey(profile.id, apiKey);
+            await this.configProcessingService.modifyConfig(configPath, (current) => ({
+                ...current,
+                activeProfileId: profile.id,
+                profiles: [...current.profiles.filter((existing) => existing.id !== profile.id), profile],
+            }));
+            await this.loggingBroker.logInformation(`profile '${profile.id}' is ready`);
+        });
+    }
+    // Sign in, and leave this machine able to run.
+    //
+    // Three processings, which is what this tier is for: the account says who you are and mints
+    // something durable, the store keeps it, and the document says which profile it belongs to. None
+    // of the three can leave the machine usable on its own.
+    signIn(configPath, email, password, profile, keyName) {
+        return this.tryCatch(async () => {
+            const account = await this.accountProcessingService.signIn(email, password, keyName);
+            await this.addProfile(configPath, { ...profile, keyId: account.key.id }, account.key.key);
+            await this.secretProcessingService.upsertRefreshToken(profile.id, account.session.refreshToken);
+            return account;
+        });
+    }
+    // The keys on the account this profile signed in to.
+    retrieveKeys(profileId) {
+        return this.tryCatch(async () => await this.accountProcessingService.retrieveApiKeys(await this.access(profileId)));
+    }
+    retrieveBalance(profileId) {
+        return this.tryCatch(async () => await this.accountProcessingService.retrieveBalance(await this.access(profileId)));
+    }
+    // A short-lived token, bought with the long-lived one, for the length of one command.
+    //
+    // Never kept. An access token written to disk would be a second secret with a shorter life than
+    // the first and no way to tell when it died, and the refresh token can always buy another.
+    async access(profileId) {
+        const refreshToken = await this.secretProcessingService.retrieveRefreshToken(profileId);
+        // A profile whose key was typed in never had a session. There is an account behind that key and
+        // this client has no way to ask about it, which is a thing to say rather than a failure.
+        if (refreshToken === null || refreshToken.length === 0) {
+            throw new NoConnectionException(`the profile '${profileId}' was set up with a key rather than a sign-in, so this client cannot ask about its account. Run peerllm login to sign in.`);
+        }
+        return (await this.accountProcessingService.refreshSession(refreshToken)).accessToken;
+    }
+    // Sign out, and leave this machine unable to run.
+    //
+    // The refresh token on disk is the only thing that can end a session started days ago, which is
+    // why it was kept. The key this client minted goes with it, because a key left alive after a sign
+    // out is a key nobody remembers having.
+    //
+    // Answers whether that key was actually revoked, which is not the same as whether the sign out
+    // worked. Two machines can both be signed out and only one of them has had a key ended.
+    //
+    // What is on disk is cleared whatever the service said. A sign out that failed at the far end and
+    // left the local key working would be the worst of the two outcomes: the user believes they are
+    // signed out and the machine can still spend their tokens.
+    signOut(configPath, profileId) {
+        return this.tryCatch(async () => {
+            const document = await this.configProcessingService.retrieveConfig(configPath);
+            const profile = document.profiles.find((candidate) => candidate.id === profileId);
+            const refreshToken = await this.secretProcessingService.retrieveRefreshToken(profileId);
+            try {
+                // Revoking the key needs a session to authorise it. A machine set up with a pasted key
+                // never had one, so there is nothing here that can end that key: it stays live in the
+                // account it was minted from, and the only person who can end it is the person who owns
+                // it. Answered rather than assumed, because that is the one case where somebody has to be
+                // told to go and do something themselves.
+                if (refreshToken === null || refreshToken.length === 0) {
+                    return false;
+                }
+                const session = await this.accountProcessingService.refreshSession(refreshToken);
+                await this.accountProcessingService.signOut(session.accessToken, session.refreshToken, profile?.keyId ?? "");
+                return (profile?.keyId ?? "").length > 0;
+            }
+            finally {
+                await this.forget(configPath, profileId);
+            }
+        });
+    }
+    // Everything this machine was holding for that profile. The key and the token are emptied rather
+    // than removed, because the store keeps one document and a name with nothing behind it reads the
+    // same as a name that was never there.
+    async forget(configPath, profileId) {
+        // Forgotten, not emptied. An empty secret is refused, for good reason, and using that refusal
+        // as the way to forget a key meant a machine set up with a pasted key could not be signed out
+        // at all: it was told its key "was given no value" and stayed able to spend.
+        await this.secretProcessingService.forgetSecrets(profileId);
+        await this.configProcessingService.modifyConfig(configPath, (current) => ({
+            ...current,
+            activeProfileId: current.activeProfileId === profileId ? "" : current.activeProfileId,
+            profiles: current.profiles.filter((candidate) => candidate.id !== profileId),
+        }));
+        await this.loggingBroker.logInformation(`profile '${profileId}' is signed out`);
+    }
+}
+function activeProfileOf(document) {
+    const profile = document.profiles.find((candidate) => candidate.id === document.activeProfileId);
+    if (profile === undefined) {
+        throw new NoConnectionException("no profile is configured. Run peerllm init to sign in.");
+    }
+    return profile;
+}
+//# sourceMappingURL=ConnectionOrchestrationService.js.map

package/dist/services/orchestrations/connections/ConnectionOrchestrationService.js.map

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

package/dist/services/processings/accounts/AccountProcessingService.Exceptions.d.ts

@@ -0,0 +1,4 @@
+import type { LoggingBroker } from "@hassanhabib/standard-agents";
+export type TryCatch = <T>(routine: () => Promise<T>) => Promise<T>;
+export declare function createTryCatch(loggingBroker: LoggingBroker): TryCatch;
+//# sourceMappingURL=AccountProcessingService.Exceptions.d.ts.map

package/dist/services/processings/accounts/AccountProcessingService.Exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountProcessingService.Exceptions.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/accounts/AccountProcessingService.Exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAgBlE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpE,wBAAgB,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,QAAQ,CAiDrE"}

package/dist/services/processings/accounts/AccountProcessingService.Exceptions.js

@@ -0,0 +1,35 @@
+import { AccountDependencyException } from "../../../models/foundations/accounts/exceptions/AccountDependencyException.js";
+import { AccountDependencyValidationException } from "../../../models/foundations/accounts/exceptions/AccountDependencyValidationException.js";
+import { AccountServiceException } from "../../../models/foundations/accounts/exceptions/AccountServiceException.js";
+import { AccountValidationException } from "../../../models/foundations/accounts/exceptions/AccountValidationException.js";
+import { AccountProcessingDependencyException } from "../../../models/processings/accounts/exceptions/AccountProcessingDependencyException.js";
+import { AccountProcessingDependencyValidationException } from "../../../models/processings/accounts/exceptions/AccountProcessingDependencyValidationException.js";
+import { AccountProcessingServiceException } from "../../../models/processings/accounts/exceptions/AccountProcessingServiceException.js";
+import { AccountProcessingValidationException } from "../../../models/processings/accounts/exceptions/AccountProcessingValidationException.js";
+import { FailedAccountProcessingServiceException } from "../../../models/processings/accounts/exceptions/FailedAccountProcessingServiceException.js";
+import { InvalidAccountProcessingException } from "../../../models/processings/accounts/exceptions/InvalidAccountProcessingException.js";
+export function createTryCatch(loggingBroker) {
+    return async function tryCatch(routine) {
+        try {
+            return await routine();
+        }
+        catch (error) {
+            if (error instanceof InvalidAccountProcessingException) {
+                throw await createAndLog(loggingBroker, new AccountProcessingValidationException("Account processing validation error occurred, fix the error and try again.", error));
+            }
+            if (error instanceof AccountValidationException || error instanceof AccountDependencyValidationException) {
+                throw await createAndLog(loggingBroker, new AccountProcessingDependencyValidationException("Account processing dependency validation error occurred, fix the error and try again.", error.innerError));
+            }
+            if (error instanceof AccountDependencyException || error instanceof AccountServiceException) {
+                throw await createAndLog(loggingBroker, new AccountProcessingDependencyException("Account processing dependency error occurred, contact support.", error.innerError));
+            }
+            const failed = new FailedAccountProcessingServiceException("Failed account processing service error occurred, contact support.", error instanceof Error ? error : new Error(String(error)));
+            throw await createAndLog(loggingBroker, new AccountProcessingServiceException("Account processing service error occurred, contact support.", failed));
+        }
+    };
+}
+async function createAndLog(loggingBroker, exception) {
+    await loggingBroker.logError(exception);
+    return exception;
+}
+//# sourceMappingURL=AccountProcessingService.Exceptions.js.map

package/dist/services/processings/accounts/AccountProcessingService.Exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountProcessingService.Exceptions.js","sourceRoot":"","sources":["../../../../src/services/processings/accounts/AccountProcessingService.Exceptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+EAA+E,CAAC;AAC3H,OAAO,EAAE,oCAAoC,EAAE,MAAM,yFAAyF,CAAC;AAC/I,OAAO,EAAE,uBAAuB,EAAE,MAAM,4EAA4E,CAAC;AACrH,OAAO,EAAE,0BAA0B,EAAE,MAAM,+EAA+E,CAAC;AAC3H,OAAO,EAAE,oCAAoC,EAAE,MAAM,yFAAyF,CAAC;AAC/I,OAAO,EAAE,8CAA8C,EAAE,MAAM,mGAAmG,CAAC;AACnK,OAAO,EAAE,iCAAiC,EAAE,MAAM,sFAAsF,CAAC;AACzI,OAAO,EAAE,oCAAoC,EAAE,MAAM,yFAAyF,CAAC;AAC/I,OAAO,EAAE,uCAAuC,EAAE,MAAM,4FAA4F,CAAC;AACrJ,OAAO,EAAE,iCAAiC,EAAE,MAAM,sFAAsF,CAAC;AAOzI,MAAM,UAAU,cAAc,CAAC,aAA4B;IACzD,OAAO,KAAK,UAAU,QAAQ,CAAI,OAAyB;QACzD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,iCAAiC,EAAE,CAAC;gBACvD,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,oCAAoC,CACtC,4EAA4E,EAC5E,KAAK,CACN,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,0BAA0B,IAAI,KAAK,YAAY,oCAAoC,EAAE,CAAC;gBACzG,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,8CAA8C,CAChD,uFAAuF,EACvF,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,0BAA0B,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;gBAC5F,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,oCAAoC,CACtC,gEAAgE,EAChE,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,uCAAuC,CACxD,oEAAoE,EACpE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;YAEF,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,iCAAiC,CACnC,6DAA6D,EAC7D,MAAM,CACP,CACF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAkB,aAA4B,EAAE,SAAY;IACrF,MAAM,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAExC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/services/processings/accounts/AccountProcessingService.d.ts

@@ -0,0 +1,18 @@
+import type { LoggingBroker } from "@hassanhabib/standard-agents";
+import type { AccountKey } from "../../../models/brokers/accounts/AccountKey.js";
+import type { AccountSession } from "../../../models/brokers/accounts/AccountSession.js";
+import type { TokenBalance } from "../../../models/brokers/accounts/TokenBalance.js";
+import type { SignedInAccount } from "../../../models/processings/accounts/SignedInAccount.js";
+import type { AccountService } from "../../foundations/accounts/AccountService.js";
+export declare class AccountProcessingService {
+    private readonly accountService;
+    private readonly tryCatch;
+    constructor(accountService: AccountService, loggingBroker: LoggingBroker);
+    signIn(email: string, password: string, keyName: string): Promise<SignedInAccount>;
+    signOut(accessToken: string, refreshToken: string, keyId: string): Promise<void>;
+    refreshSession(refreshToken: string): Promise<AccountSession>;
+    retrieveApiKeys(accessToken: string): Promise<readonly AccountKey[]>;
+    removeApiKey(accessToken: string, id: string): Promise<void>;
+    retrieveBalance(accessToken: string): Promise<TokenBalance>;
+}
+//# sourceMappingURL=AccountProcessingService.d.ts.map

package/dist/services/processings/accounts/AccountProcessingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountProcessingService.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/accounts/AccountProcessingService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yDAAyD,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAQnF,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAEjB,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa;IASxE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAclF,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhF,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI7D,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;IAIpE,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5D,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAGnE"}

package/dist/services/processings/accounts/AccountProcessingService.js

@@ -0,0 +1,53 @@
+import { createTryCatch } from "./AccountProcessingService.Exceptions.js";
+// Higher order over the account (SPEC.md 8.6): the combinations the commands actually need.
+//
+// The foundation offers seven separate acts. Nobody wants any one of them: what a person wants is
+// to sign in, which is a login and a minting, and to sign out, which is a revocation and a logout.
+// Those pairs live here, because a pair half done is worse than either half.
+export class AccountProcessingService {
+    accountService;
+    tryCatch;
+    constructor(accountService, loggingBroker) {
+        this.accountService = accountService;
+        this.tryCatch = createTryCatch(loggingBroker);
+    }
+    // Prove who you are, then come away with something that still works tomorrow.
+    //
+    // The login's tokens are short lived, so a client that stopped here would be signed in for an
+    // hour. The key is the thing worth keeping, and minting one is the only way to get it.
+    signIn(email, password, keyName) {
+        return this.tryCatch(async () => {
+            const session = await this.accountService.login(email, password);
+            const key = await this.accountService.addApiKey(session.accessToken, keyName);
+            return { session, key };
+        });
+    }
+    // The key this client minted goes first, then the session.
+    //
+    // In that order because the session is what authorises the revocation: ending it first would
+    // leave the key alive with nothing left that could remove it. A key that was never minted is
+    // nothing to revoke rather than a reason not to sign out.
+    signOut(accessToken, refreshToken, keyId) {
+        return this.tryCatch(async () => {
+            if (keyId.trim().length > 0) {
+                await this.accountService.removeApiKey(accessToken, keyId);
+            }
+            await this.accountService.endSession(accessToken, refreshToken);
+        });
+    }
+    refreshSession(refreshToken) {
+        return this.tryCatch(async () => await this.accountService.refreshSession(refreshToken));
+    }
+    retrieveApiKeys(accessToken) {
+        return this.tryCatch(async () => await this.accountService.retrieveApiKeys(accessToken));
+    }
+    removeApiKey(accessToken, id) {
+        return this.tryCatch(async () => {
+            await this.accountService.removeApiKey(accessToken, id);
+        });
+    }
+    retrieveBalance(accessToken) {
+        return this.tryCatch(async () => await this.accountService.retrieveBalance(accessToken));
+    }
+}
+//# sourceMappingURL=AccountProcessingService.js.map

package/dist/services/processings/accounts/AccountProcessingService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountProcessingService.js","sourceRoot":"","sources":["../../../../src/services/processings/accounts/AccountProcessingService.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAiB,MAAM,0CAA0C,CAAC;AAEzF,4FAA4F;AAC5F,EAAE;AACF,kGAAkG;AAClG,mGAAmG;AACnG,6EAA6E;AAC7E,MAAM,OAAO,wBAAwB;IAClB,cAAc,CAAiB;IAC/B,QAAQ,CAAW;IAEpC,YAAmB,cAA8B,EAAE,aAA4B;QAC7E,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,8EAA8E;IAC9E,EAAE;IACF,8FAA8F;IAC9F,uFAAuF;IAChF,MAAM,CAAC,KAAa,EAAE,QAAgB,EAAE,OAAe;QAC5D,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACjE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAE9E,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2DAA2D;IAC3D,EAAE;IACF,6FAA6F;IAC7F,6FAA6F;IAC7F,0DAA0D;IACnD,OAAO,CAAC,WAAmB,EAAE,YAAoB,EAAE,KAAa;QACrE,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC7D,CAAC;YAED,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,cAAc,CAAC,YAAoB;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IAC3F,CAAC;IAEM,eAAe,CAAC,WAAmB;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3F,CAAC;IAEM,YAAY,CAAC,WAAmB,EAAE,EAAU;QACjD,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,eAAe,CAAC,WAAmB;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3F,CAAC;CACF"}

package/dist/services/processings/configs/ConfigProcessingService.Exceptions.d.ts

@@ -0,0 +1,4 @@
+import type { LoggingBroker } from "@hassanhabib/standard-agents";
+export type TryCatch = <T>(routine: () => Promise<T>) => Promise<T>;
+export declare function createTryCatch(loggingBroker: LoggingBroker): TryCatch;
+//# sourceMappingURL=ConfigProcessingService.Exceptions.d.ts.map

package/dist/services/processings/configs/ConfigProcessingService.Exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigProcessingService.Exceptions.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/configs/ConfigProcessingService.Exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAgBlE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpE,wBAAgB,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,QAAQ,CA2DrE"}

package/dist/services/processings/configs/ConfigProcessingService.Exceptions.js

@@ -0,0 +1,38 @@
+import { ConfigDependencyException } from "../../../models/foundations/configs/exceptions/ConfigDependencyException.js";
+import { ConfigDependencyValidationException } from "../../../models/foundations/configs/exceptions/ConfigDependencyValidationException.js";
+import { ConfigServiceException } from "../../../models/foundations/configs/exceptions/ConfigServiceException.js";
+import { ConfigValidationException } from "../../../models/foundations/configs/exceptions/ConfigValidationException.js";
+import { ConfigProcessingDependencyException } from "../../../models/processings/configs/exceptions/ConfigProcessingDependencyException.js";
+import { ConfigProcessingDependencyValidationException } from "../../../models/processings/configs/exceptions/ConfigProcessingDependencyValidationException.js";
+import { ConfigProcessingServiceException } from "../../../models/processings/configs/exceptions/ConfigProcessingServiceException.js";
+import { ConfigProcessingValidationException } from "../../../models/processings/configs/exceptions/ConfigProcessingValidationException.js";
+import { FailedConfigProcessingServiceException } from "../../../models/processings/configs/exceptions/FailedConfigProcessingServiceException.js";
+import { LockUnavailableConfigProcessingException } from "../../../models/processings/configs/exceptions/LockUnavailableConfigProcessingException.js";
+export function createTryCatch(loggingBroker) {
+    return async function tryCatch(routine) {
+        try {
+            return await routine();
+        }
+        catch (error) {
+            if (error instanceof LockUnavailableConfigProcessingException) {
+                throw await createAndLog(loggingBroker, new ConfigProcessingDependencyValidationException("Config processing dependency validation error occurred, fix the error and try again.", error));
+            }
+            if (error instanceof ConfigValidationException) {
+                throw await createAndLog(loggingBroker, new ConfigProcessingValidationException("Config processing validation error occurred, fix the error and try again.", error.innerError));
+            }
+            if (error instanceof ConfigDependencyValidationException) {
+                throw await createAndLog(loggingBroker, new ConfigProcessingDependencyValidationException("Config processing dependency validation error occurred, fix the error and try again.", error.innerError));
+            }
+            if (error instanceof ConfigDependencyException || error instanceof ConfigServiceException) {
+                throw await createAndLog(loggingBroker, new ConfigProcessingDependencyException("Config processing dependency error occurred, contact support.", error.innerError));
+            }
+            const failedConfigProcessingServiceException = new FailedConfigProcessingServiceException("Failed config processing service error occurred, contact support.", error instanceof Error ? error : new Error(String(error)));
+            throw await createAndLog(loggingBroker, new ConfigProcessingServiceException("Config processing service error occurred, contact support.", failedConfigProcessingServiceException));
+        }
+    };
+}
+async function createAndLog(loggingBroker, exception) {
+    await loggingBroker.logError(exception);
+    return exception;
+}
+//# sourceMappingURL=ConfigProcessingService.Exceptions.js.map

package/dist/services/processings/configs/ConfigProcessingService.Exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigProcessingService.Exceptions.js","sourceRoot":"","sources":["../../../../src/services/processings/configs/ConfigProcessingService.Exceptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6EAA6E,CAAC;AACxH,OAAO,EAAE,mCAAmC,EAAE,MAAM,uFAAuF,CAAC;AAC5I,OAAO,EAAE,sBAAsB,EAAE,MAAM,0EAA0E,CAAC;AAClH,OAAO,EAAE,yBAAyB,EAAE,MAAM,6EAA6E,CAAC;AACxH,OAAO,EAAE,mCAAmC,EAAE,MAAM,uFAAuF,CAAC;AAC5I,OAAO,EAAE,6CAA6C,EAAE,MAAM,iGAAiG,CAAC;AAChK,OAAO,EAAE,gCAAgC,EAAE,MAAM,oFAAoF,CAAC;AACtI,OAAO,EAAE,mCAAmC,EAAE,MAAM,uFAAuF,CAAC;AAC5I,OAAO,EAAE,sCAAsC,EAAE,MAAM,0FAA0F,CAAC;AAClJ,OAAO,EAAE,wCAAwC,EAAE,MAAM,4FAA4F,CAAC;AAOtJ,MAAM,UAAU,cAAc,CAAC,aAA4B;IACzD,OAAO,KAAK,UAAU,QAAQ,CAAI,OAAyB;QACzD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,wCAAwC,EAAE,CAAC;gBAC9D,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,6CAA6C,CAC/C,sFAAsF,EACtF,KAAK,CACN,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,yBAAyB,EAAE,CAAC;gBAC/C,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,mCAAmC,CACrC,2EAA2E,EAC3E,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,mCAAmC,EAAE,CAAC;gBACzD,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,6CAA6C,CAC/C,sFAAsF,EACtF,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,yBAAyB,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;gBAC1F,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,mCAAmC,CACrC,+DAA+D,EAC/D,KAAK,CAAC,UAAU,CACjB,CACF,CAAC;YACJ,CAAC;YAED,MAAM,sCAAsC,GAAG,IAAI,sCAAsC,CACvF,mEAAmE,EACnE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;YAEF,MAAM,MAAM,YAAY,CACtB,aAAa,EACb,IAAI,gCAAgC,CAClC,4DAA4D,EAC5D,sCAAsC,CACvC,CACF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAkB,aAA4B,EAAE,SAAY;IACrF,MAAM,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAExC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/services/processings/configs/ConfigProcessingService.d.ts

@@ -0,0 +1,24 @@
+import type { LoggingBroker, TimeBroker } from "@hassanhabib/standard-agents";
+import { type ConfigDocument } from "../../../models/foundations/configs/ConfigDocument.js";
+import { type HealthCheck } from "../../../models/processings/health/HealthCheck.js";
+import type { ConfigService } from "../../foundations/configs/ConfigService.js";
+export declare const LOCK_RETRY_MILLISECONDS = 50;
+export declare const LOCK_WAIT_MILLISECONDS = 5000;
+export declare const LOCK_STALE_MILLISECONDS = 30000;
+export declare class ConfigProcessingService {
+    private readonly configService;
+    private readonly loggingBroker;
+    private readonly timeBroker;
+    private readonly retryMilliseconds;
+    private readonly waitMilliseconds;
+    private readonly tryCatch;
+    constructor(configService: ConfigService, loggingBroker: LoggingBroker, timeBroker: TimeBroker, retryMilliseconds?: number, waitMilliseconds?: number);
+    retrieveConfig(path: string): Promise<ConfigDocument>;
+    verifyConfig(path: string): Promise<HealthCheck>;
+    modifyConfig(path: string, change: (document: ConfigDocument) => ConfigDocument): Promise<ConfigDocument>;
+    private readOrDefault;
+    private takeLock;
+    private attemptLock;
+    private reclaimIfStale;
+}
+//# sourceMappingURL=ConfigProcessingService.d.ts.map

package/dist/services/processings/configs/ConfigProcessingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigProcessingService.d.ts","sourceRoot":"","sources":["../../../../src/services/processings/configs/ConfigProcessingService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE9E,OAAO,EAA+B,KAAK,cAAc,EAAE,MAAM,uDAAuD,CAAC;AAKzH,OAAO,EAAqC,KAAK,WAAW,EAAE,MAAM,mDAAmD,CAAC;AACxH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAShF,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAE5C,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAGlC,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,UAAU,EACtB,iBAAiB,SAA0B,EAC3C,gBAAgB,SAAyB;IAcpC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAKrD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAiChD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;YAoBlG,aAAa;YAcb,QAAQ;YAuBR,WAAW;YAgBX,cAAc;CAY7B"}