@sprucelabs/spruce-agent-utils 0.0.1 → 0.1.0

package/build/.spruce/errors/errors.types.d.ts

@@ -0,0 +1,13 @@
+import { default as SchemaEntity } from '@sprucelabs/schema';
+import * as SpruceSchema from '@sprucelabs/schema';
+export declare namespace SpruceErrors.SpruceAgentUtils {
+    interface AgentLoaderNotConfigured {
+    }
+    interface AgentLoaderNotConfiguredSchema extends SpruceSchema.Schema {
+        id: 'agentLoaderNotConfigured';
+        namespace: 'SpruceAgentUtils';
+        name: 'agent loader not configured';
+        fields: {};
+    }
+    type AgentLoaderNotConfiguredEntity = SchemaEntity<SpruceErrors.SpruceAgentUtils.AgentLoaderNotConfiguredSchema>;
+}

package/build/.spruce/errors/errors.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/.spruce/errors/options.types.d.ts

@@ -0,0 +1,7 @@
+import { SpruceErrors } from "./errors.types";
+import { ErrorOptions as ISpruceErrorOptions } from "@sprucelabs/error";
+export interface AgentLoaderNotConfiguredErrorOptions extends SpruceErrors.SpruceAgentUtils.AgentLoaderNotConfigured, ISpruceErrorOptions {
+    code: 'AGENT_LOADER_NOT_CONFIGURED';
+}
+type ErrorOptions = AgentLoaderNotConfiguredErrorOptions;
+export default ErrorOptions;

package/build/.spruce/errors/options.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/.spruce/errors/spruceAgentUtils/agentLoaderNotConfigured.schema.d.ts

@@ -0,0 +1,3 @@
+import { SpruceErrors } from '../errors.types';
+declare const agentLoaderNotConfiguredSchema: SpruceErrors.SpruceAgentUtils.AgentLoaderNotConfiguredSchema;
+export default agentLoaderNotConfiguredSchema;

package/build/.spruce/errors/spruceAgentUtils/agentLoaderNotConfigured.schema.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const schema_1 = require("@sprucelabs/schema");
+const agentLoaderNotConfiguredSchema = {
+    id: 'agentLoaderNotConfigured',
+    namespace: 'SpruceAgentUtils',
+    name: 'agent loader not configured',
+    fields: {}
+};
+schema_1.SchemaRegistry.getInstance().trackSchema(agentLoaderNotConfiguredSchema);
+exports.default = agentLoaderNotConfiguredSchema;

package/build/.spruce/schemas/fields/fieldClassMap.d.ts

@@ -0,0 +1,2 @@
+import { fieldClassMap } from '@sprucelabs/schema';
+export default fieldClassMap;

package/build/.spruce/schemas/fields/fieldClassMap.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const schema_1 = require("@sprucelabs/schema");
+exports.default = schema_1.fieldClassMap;

package/{src/.spruce/schemas/fields/fields.types.ts → build/.spruce/schemas/fields/fields.types.d.ts}

@@ -1 +1 @@
-export { FieldDefinitions, FieldDefinitionMap, FieldValueTypeGeneratorMap, FieldMap } from '@sprucelabs/schema'
+export { FieldDefinitions, FieldDefinitionMap, FieldValueTypeGeneratorMap, FieldMap } from '@sprucelabs/schema';

package/build/.spruce/schemas/fields/fields.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/{src → build}/.spruce/settings.json

@@ -3,13 +3,13 @@
     "skipped": []
   },
   "skipped": [
-    "skill"
+    "event",
+    "skill",
+    "permission"
   ],
   "installed": [
     "test",
     "schema",
-    "error",
-    "permission",
-    "event"
+    "error"
   ]
 }

package/build/SpruceAgent.d.ts

@@ -0,0 +1,15 @@
+import { MercuryClient } from '@sprucelabs/mercury-client';
+export default class SpruceAgent implements AgentLoader {
+    private static instance?;
+    private connectToApi;
+    private constructor();
+    static setup(client: MercuryClient | ConnectFactory): void;
+    static reset(): void;
+    static getInstance(): SpruceAgent;
+    getName(): Promise<string>;
+}
+export interface AgentLoader {
+    getName(): Promise<string>;
+}
+type ConnectFactory = () => Promise<MercuryClient>;
+export {};

package/build/SpruceAgent.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const SpruceError_1 = __importDefault(require("./errors/SpruceError"));
+class SpruceAgent {
+    constructor(client) {
+        this.connectToApi =
+            typeof client === 'function' ? client : async () => client;
+    }
+    static setup(client) {
+        this.instance = new SpruceAgent(client);
+    }
+    static reset() {
+        delete this.instance;
+    }
+    static getInstance() {
+        if (this.instance) {
+            return this.instance;
+        }
+        throw new SpruceError_1.default({
+            code: 'AGENT_LOADER_NOT_CONFIGURED',
+        });
+    }
+    async getName() {
+        const client = await this.connectToApi();
+        const [{ name }] = await client.emitAndFlattenResponses('get-agent-name::v2020_12_25');
+        return name;
+    }
+}
+exports.default = SpruceAgent;

package/build/agentAssert.d.ts

@@ -0,0 +1,7 @@
+import { MercuryClient } from '@sprucelabs/mercury-client';
+declare const agentAssert: {
+    beforeEach(client: MercuryClient): Promise<void>;
+    getName: () => string;
+    includesAgentName: (text: string) => void;
+};
+export default agentAssert;

package/build/agentAssert.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const schema_1 = require("@sprucelabs/schema");
+const spruce_test_fixtures_1 = require("@sprucelabs/spruce-test-fixtures");
+const test_utils_1 = require("@sprucelabs/test-utils");
+const SpruceAgent_1 = __importDefault(require("./SpruceAgent"));
+let sharedClient;
+let name = (0, test_utils_1.generateId)();
+const agentAssert = {
+    async beforeEach(client) {
+        name = (0, test_utils_1.generateId)();
+        sharedClient = client;
+        await spruce_test_fixtures_1.eventFaker.on('get-agent-name::v2020_12_25', () => {
+            return { name };
+        });
+    },
+    getName: () => {
+        test_utils_1.assert.isTruthy(sharedClient, 'You must call agentAssert.beforeEach(this.fakedClient) in your test to use agentAssert');
+        SpruceAgent_1.default.getInstance();
+        return name;
+    },
+    includesAgentName: (text) => {
+        (0, schema_1.assertOptions)({ text }, ['text']);
+        test_utils_1.assert.doesInclude(text, name, `The text must include agent name!`);
+    },
+};
+exports.default = agentAssert;

package/build/errors/SpruceError.d.ts

@@ -0,0 +1,6 @@
+import BaseSpruceError from '@sprucelabs/error';
+import ErrorOptions from './../.spruce/errors/options.types';
+export default class SpruceError extends BaseSpruceError<ErrorOptions> {
+    /** an easy to understand version of the errors */
+    friendlyMessage(): string;
+}

package/build/errors/SpruceError.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const error_1 = __importDefault(require("@sprucelabs/error"));
+class SpruceError extends error_1.default {
+    /** an easy to understand version of the errors */
+    friendlyMessage() {
+        const { options } = this;
+        let message;
+        switch (options?.code) {
+            case 'AGENT_LOADER_NOT_CONFIGURED':
+                message = `The agent loader has not been configured. Please call SpruceAgent.setup(...) first. Best place is probably in the did-boot of your skill or the constructor of your AppViewController in the front-end.`;
+                break;
+            default:
+                message = super.friendlyMessage();
+        }
+        const fullMessage = options.friendlyMessage
+            ? options.friendlyMessage
+            : message;
+        return fullMessage;
+    }
+}
+exports.default = SpruceError;

package/build/errors/agentLoaderNotConfigured.builder.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    id: string;
+    name: string;
+    fields: {};
+};
+export default _default;

package/build/errors/agentLoaderNotConfigured.builder.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const schema_1 = require("@sprucelabs/schema");
+exports.default = (0, schema_1.buildErrorSchema)({
+    id: 'agentLoaderNotConfigured',
+    name: 'agent loader not configured',
+    fields: {},
+});

package/build/esm/.spruce/errors/errors.types.d.ts

@@ -0,0 +1,13 @@
+import { default as SchemaEntity } from '@sprucelabs/schema';
+import * as SpruceSchema from '@sprucelabs/schema';
+export declare namespace SpruceErrors.SpruceAgentUtils {
+    interface AgentLoaderNotConfigured {
+    }
+    interface AgentLoaderNotConfiguredSchema extends SpruceSchema.Schema {
+        id: 'agentLoaderNotConfigured';
+        namespace: 'SpruceAgentUtils';
+        name: 'agent loader not configured';
+        fields: {};
+    }
+    type AgentLoaderNotConfiguredEntity = SchemaEntity<SpruceErrors.SpruceAgentUtils.AgentLoaderNotConfiguredSchema>;
+}

package/build/esm/.spruce/errors/errors.types.js

@@ -0,0 +1 @@
+export {};

package/build/esm/.spruce/errors/options.types.d.ts

@@ -0,0 +1,7 @@
+import { SpruceErrors } from "./errors.types";
+import { ErrorOptions as ISpruceErrorOptions } from "@sprucelabs/error";
+export interface AgentLoaderNotConfiguredErrorOptions extends SpruceErrors.SpruceAgentUtils.AgentLoaderNotConfigured, ISpruceErrorOptions {
+    code: 'AGENT_LOADER_NOT_CONFIGURED';
+}
+type ErrorOptions = AgentLoaderNotConfiguredErrorOptions;
+export default ErrorOptions;

package/build/esm/.spruce/errors/options.types.js

@@ -0,0 +1 @@
+export {};

package/build/esm/.spruce/errors/spruceAgentUtils/agentLoaderNotConfigured.schema.d.ts

@@ -0,0 +1,3 @@
+import { SpruceErrors } from '../errors.types';
+declare const agentLoaderNotConfiguredSchema: SpruceErrors.SpruceAgentUtils.AgentLoaderNotConfiguredSchema;
+export default agentLoaderNotConfiguredSchema;

package/build/esm/.spruce/errors/spruceAgentUtils/agentLoaderNotConfigured.schema.js

@@ -0,0 +1,9 @@
+import { SchemaRegistry } from '@sprucelabs/schema';
+const agentLoaderNotConfiguredSchema = {
+    id: 'agentLoaderNotConfigured',
+    namespace: 'SpruceAgentUtils',
+    name: 'agent loader not configured',
+    fields: {}
+};
+SchemaRegistry.getInstance().trackSchema(agentLoaderNotConfiguredSchema);
+export default agentLoaderNotConfiguredSchema;

package/build/esm/.spruce/schemas/fields/fieldClassMap.d.ts

@@ -0,0 +1,2 @@
+import { fieldClassMap } from '@sprucelabs/schema';
+export default fieldClassMap;

package/build/esm/.spruce/schemas/fields/fieldClassMap.js

@@ -0,0 +1,2 @@
+import { fieldClassMap } from '@sprucelabs/schema';
+export default fieldClassMap;

package/build/esm/.spruce/schemas/fields/fields.types.d.ts

@@ -0,0 +1 @@
+export { FieldDefinitions, FieldDefinitionMap, FieldValueTypeGeneratorMap, FieldMap } from '@sprucelabs/schema';

package/build/esm/.spruce/schemas/fields/fields.types.js

@@ -0,0 +1 @@
+export {};

package/build/esm/SpruceAgent.d.ts

@@ -0,0 +1,15 @@
+import { MercuryClient } from '@sprucelabs/mercury-client';
+export default class SpruceAgent implements AgentLoader {
+    private static instance?;
+    private connectToApi;
+    private constructor();
+    static setup(client: MercuryClient | ConnectFactory): void;
+    static reset(): void;
+    static getInstance(): SpruceAgent;
+    getName(): Promise<string>;
+}
+export interface AgentLoader {
+    getName(): Promise<string>;
+}
+type ConnectFactory = () => Promise<MercuryClient>;
+export {};

package/build/esm/SpruceAgent.js

@@ -0,0 +1,26 @@
+import SpruceError from './errors/SpruceError.js';
+export default class SpruceAgent {
+    constructor(client) {
+        this.connectToApi =
+            typeof client === 'function' ? client : async () => client;
+    }
+    static setup(client) {
+        this.instance = new SpruceAgent(client);
+    }
+    static reset() {
+        delete this.instance;
+    }
+    static getInstance() {
+        if (this.instance) {
+            return this.instance;
+        }
+        throw new SpruceError({
+            code: 'AGENT_LOADER_NOT_CONFIGURED',
+        });
+    }
+    async getName() {
+        const client = await this.connectToApi();
+        const [{ name }] = await client.emitAndFlattenResponses('get-agent-name::v2020_12_25');
+        return name;
+    }
+}

package/build/esm/agentAssert.d.ts

@@ -0,0 +1,7 @@
+import { MercuryClient } from '@sprucelabs/mercury-client';
+declare const agentAssert: {
+    beforeEach(client: MercuryClient): Promise<void>;
+    getName: () => string;
+    includesAgentName: (text: string) => void;
+};
+export default agentAssert;

package/build/esm/agentAssert.js

@@ -0,0 +1,25 @@
+import { assertOptions } from '@sprucelabs/schema';
+import { eventFaker } from '@sprucelabs/spruce-test-fixtures';
+import { assert, generateId } from '@sprucelabs/test-utils';
+import SpruceAgent from './SpruceAgent.js';
+let sharedClient;
+let name = generateId();
+const agentAssert = {
+    async beforeEach(client) {
+        name = generateId();
+        sharedClient = client;
+        await eventFaker.on('get-agent-name::v2020_12_25', () => {
+            return { name };
+        });
+    },
+    getName: () => {
+        assert.isTruthy(sharedClient, 'You must call agentAssert.beforeEach(this.fakedClient) in your test to use agentAssert');
+        SpruceAgent.getInstance();
+        return name;
+    },
+    includesAgentName: (text) => {
+        assertOptions({ text }, ['text']);
+        assert.doesInclude(text, name, `The text must include agent name!`);
+    },
+};
+export default agentAssert;

package/build/esm/errors/SpruceError.d.ts

@@ -0,0 +1,6 @@
+import BaseSpruceError from '@sprucelabs/error';
+import ErrorOptions from './../.spruce/errors/options.types';
+export default class SpruceError extends BaseSpruceError<ErrorOptions> {
+    /** an easy to understand version of the errors */
+    friendlyMessage(): string;
+}

package/build/esm/errors/SpruceError.js

@@ -0,0 +1,19 @@
+import BaseSpruceError from '@sprucelabs/error';
+export default class SpruceError extends BaseSpruceError {
+    /** an easy to understand version of the errors */
+    friendlyMessage() {
+        const { options } = this;
+        let message;
+        switch (options === null || options === void 0 ? void 0 : options.code) {
+            case 'AGENT_LOADER_NOT_CONFIGURED':
+                message = `The agent loader has not been configured. Please call SpruceAgent.setup(...) first. Best place is probably in the did-boot of your skill or the constructor of your AppViewController in the front-end.`;
+                break;
+            default:
+                message = super.friendlyMessage();
+        }
+        const fullMessage = options.friendlyMessage
+            ? options.friendlyMessage
+            : message;
+        return fullMessage;
+    }
+}

package/build/esm/errors/agentLoaderNotConfigured.builder.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    id: string;
+    name: string;
+    fields: {};
+};
+export default _default;

package/{src/errors/agentLoaderNotConfigured.builder.ts → build/esm/errors/agentLoaderNotConfigured.builder.js}

@@ -1,7 +1,6 @@
-import { buildErrorSchema } from '@sprucelabs/schema'
-
+import { buildErrorSchema } from '@sprucelabs/schema';
 export default buildErrorSchema({
     id: 'agentLoaderNotConfigured',
     name: 'agent loader not configured',
     fields: {},
-})
+});

package/build/esm/index.d.ts

@@ -0,0 +1,3 @@
+export { default as SpruceAgent } from './SpruceAgent';
+export * from './SpruceAgent';
+export { default as agentAssert } from './agentAssert';

package/build/esm/index.js

@@ -0,0 +1,3 @@
+export { default as SpruceAgent } from './SpruceAgent.js';
+export * from './SpruceAgent.js';
+export { default as agentAssert } from './agentAssert.js';

package/build/index.d.ts

@@ -0,0 +1,3 @@
+export { default as SpruceAgent } from './SpruceAgent';
+export * from './SpruceAgent';
+export { default as agentAssert } from './agentAssert';

package/build/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentAssert = exports.SpruceAgent = void 0;
+var SpruceAgent_1 = require("./SpruceAgent");
+Object.defineProperty(exports, "SpruceAgent", { enumerable: true, get: function () { return __importDefault(SpruceAgent_1).default; } });
+__exportStar(require("./SpruceAgent"), exports);
+var agentAssert_1 = require("./agentAssert");
+Object.defineProperty(exports, "agentAssert", { enumerable: true, get: function () { return __importDefault(agentAssert_1).default; } });

package/package.json

@@ -1,20 +1,36 @@
 {
   "name": "@sprucelabs/spruce-agent-utils",
-  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "build",
+    "!build/__tests__",
+    "esm"
+  ],
+  "version": "0.1.0",
+  "main": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "module": "./build/esm/index.js",
+  "sideEffects": false,
   "scripts": {
     "build.ci": "yarn run build.tsc && yarn run build.resolve-paths && yarn run lint",
     "build.dev": "yarn run build.tsc --sourceMap ; yarn run resolve-paths.lint",
+    "build.dist": "tsc --project tsconfig.dist.json && yarn build.resolve-paths && mv build esm && yarn build.esm-postbuild && yarn build.tsc && yarn build.resolve-paths && mv esm build/ && yarn clean.dist",
     "build.copy-files": "mkdir -p build && rsync -avzq --exclude='*.ts' ./src/ ./build/",
+    "build.esm-postbuild": "esm-postbuild --target esm --patterns '**/*.js'",
     "build.resolve-paths": "resolve-path-aliases --target build --patterns '**/*.js,**/*.d.ts'",
     "build.tsc": "yarn run build.copy-files && tsc",
     "clean": "yarn run clean.build",
     "clean.all": "yarn run clean.dependencies && yarn run clean.build",
     "clean.build": "rm -rf build/",
+    "clean.dist": "rm -rf build/__tests__ build/esm/__tests__",
     "clean.dependencies": "rm -rf node_modules/ package-lock.json yarn.lock",
     "fix.lint": "eslint --fix --cache '**/*.ts'",
     "lint": "eslint --cache '**/*.ts'",
     "lint.tsc": "tsc -p . --noEmit",
     "post.watch.build": "yarn run build.copy-files && yarn run build.resolve-paths",
+    "release": "semantic-release",
     "rebuild": "yarn run clean.all && yarn install && yarn run build.dev",
     "update.dependencies": "yarn run clean.dependencies && yarn",
     "resolve-paths.lint": "yarn run build.resolve-paths ; yarn run lint",
@@ -24,8 +40,10 @@
     "watch.tsc": "tsc -w"
   },
   "devDependencies": {
+    "@sprucelabs/esm-postbuild": "^9.0.8",
     "@sprucelabs/jest-json-reporter": "^10.0.12",
     "@sprucelabs/resolve-path-aliases": "^4.0.9",
+    "@sprucelabs/semantic-release": "^6.0.0",
     "@sprucelabs/spruce-test-fixtures": "^76.0.15",
     "@sprucelabs/test": "^11.0.3",
     "@sprucelabs/test-utils": "^7.0.16",
@@ -35,7 +53,7 @@
     "eslint-config-spruce": "^11.2.26",
     "jest": "^30.2.0",
     "jest-circus": "^30.2.0",
-    "prettier": "^3.7.3",
+    "prettier": "^3.7.4",
     "ts-node": "^10.9.2",
     "tsc-watch": "^7.2.0",
     "typescript": "^5.9.3"

package/.circleci/config.yml

@@ -1,80 +0,0 @@
-version: 2.1
-orbs:
-  spruce: sprucelabsai/orb@1
-jobs:
-  test:
-    docker:
-      - image: cimg/node:lts
-    working_directory: /mnt/ramdisk
-    steps:
-      - run:
-          name: Yolo perms
-          command: sudo chmod -R 777 /mnt/ramdisk
-      - add_ssh_keys:
-          fingerprints:
-            - "ec:9f:2e:aa:1f:c9:ab:49:57:8f:c0:cd:2e:5b:f3:b0"
-      - checkout
-      - spruce/check_and_skip_if_npm_publish
-      - spruce/create_env_from_base64_env
-      - spruce/install_rsync
-      - spruce/install_deps_build_ci_test
-      - spruce/exit_if_not_auto_upgrade
-      - spruce/merge_auto_upgrade
-  npm_publish:
-    docker:
-      - image: cimg/node:lts
-    working_directory: /mnt/ramdisk
-    steps:
-      - run:
-          name: Yolo perms
-          command: sudo chmod -R 777 /mnt/ramdisk
-      - add_ssh_keys:
-          fingerprints:
-            - "ec:9f:2e:aa:1f:c9:ab:49:57:8f:c0:cd:2e:5b:f3:b0"
-      - checkout
-      - spruce/check_and_skip_if_npm_publish
-      - spruce/install_rsync
-      - spruce/install_deps_build_dist_release
-  upgrade:
-    docker:
-      - image: cimg/node:lts
-    working_directory: /mnt/ramdisk
-    steps:
-      - run:
-          name: Yolo perms
-          command: sudo chmod -R 777 /mnt/ramdisk
-      - spruce/check_for_autoupgrade_dns
-      - add_ssh_keys:
-          fingerprints:
-            - "ec:9f:2e:aa:1f:c9:ab:49:57:8f:c0:cd:2e:5b:f3:b0"
-      - spruce/check_for_ssh_keys_env
-      - spruce/setup_ct_npm_cache
-      - checkout
-      - spruce/set_target_branch_env
-      - spruce/install_rsync
-      - spruce/install_cli
-      - spruce/upgrade_check_for_major
-      - spruce/check_for_newline_only_diff
-      - spruce/create_pr
-workflows:
-  version: 2.1
-  do_build:
-    jobs:
-      - test:
-          context: public_package_publish
-      - npm_publish:
-          requires:
-            - test
-          context: public_package_publish
-          filters:
-            branches:
-              only:
-                - master
-  upgrade:
-    jobs:
-      - upgrade:
-          context: public_package_publish
-          filters:
-            branches:
-              only:
-                - never_run_only_for_cron

package/.nvmrc

@@ -1 +0,0 @@
-lts/*

package/.vscode/launch.json

@@ -1,58 +0,0 @@
-{
-	"version": "0.2.0",
-	"configurations": [
-		{
-			"type": "node",
-			"request": "attach",
-			"name": "attach.tests",
-			"port": 5200,
-			"restart": true,
-			"timeout": 10000
-		},
-		{
-			"type": "node",
-			"request": "launch",
-			"name": "test.file",
-			"runtimeExecutable": "node",
-			"runtimeArgs": [
-				"--inspect-brk",
-				"--trace-warnings",
-				"${workspaceFolder}/node_modules/.bin/jest",
-				"${fileBasenameNoExtension}",
-				"--detectOpenHandles"
-			],
-			"cwd": "${workspaceFolder}",
-			"console": "integratedTerminal",
-			"internalConsoleOptions": "neverOpen"
-		},
-		{
-			"type": "node",
-			"request": "launch",
-			"name": "test.all",
-			"runtimeExecutable": "node",
-			"runtimeArgs": [
-				"--inspect-brk",
-				"--trace-warnings",
-				"${workspaceFolder}/node_modules/.bin/jest"
-			],
-			"cwd": "${workspaceFolder}",
-			"console": "integratedTerminal",
-			"internalConsoleOptions": "neverOpen"
-		},
-		{
-			"type": "node",
-			"request": "launch",
-			"name": "boot",
-			"runtimeExecutable": "yarn",
-			"runtimeArgs": [
-				"run",
-				"--inspect-brk",
-				"--trace-warnings",
-				"boot"
-			],
-			"cwd": "${workspaceFolder}",
-			"console": "integratedTerminal",
-			"internalConsoleOptions": "neverOpen"
-		}
-	]
-}

package/.vscode/settings.json

@@ -1,67 +0,0 @@
-{
-	"debug.node.autoAttach": "on",
-	"git.ignoreLimitWarning": true,
-	"javascript.validate.enable": false,
-	"files.watcherExclude": {
-		"**/.git/objects/**": true,
-		"**/.git/subtree-cache/**": true,
-		"**/build/**": true,
-		"**/node_modules/**": true,
-	},
-	"search.exclude": {
-		"**/build/**": true,
-		"**/node_modules/**": true,
-		"**/.next/**": true
-	},
-	"editor.maxTokenizationLineLength": 20000000,
-	"[javascript]": {
-		"editor.formatOnSave": false
-	},
-	"[javascriptreact]": {
-		"editor.formatOnSave": false
-	},
-	"[typescript]": {
-		"editor.formatOnSave": false
-	},
-	"[typescriptreact]": {
-		"editor.formatOnSave": false
-	},
-	"[handlebars]": {
-		"editor.formatOnSave": false
-	},
-	"typescript.tsdk": "node_modules/typescript/lib",
-	"cSpell.ignorePaths": [
-		"**/package-lock.json",
-		"**/node_modules/**",
-		"**/build/**",
-		"**/vscode-extension/**",
-		"**/.git/objects/**",
-		".vscode",
-		".spruce"
-	],
-	"cSpell.words": [
-		"arkit",
-		"autogenerated",
-		"scrollable",
-		"serializable"
-	],
-	"debug.javascript.unmapMissingSources": true,
-	"javascript.preferences.importModuleSpecifier": "relative",
-	"typescript.preferences.importModuleSpecifier": "relative",
-	"eslint.useFlatConfig": true,
-	"eslint.enable": true,
-	"eslint.validate": [
-		"javascript",
-		"javascriptreact",
-		"typescript",
-		"typescriptreact"
-	],
-	"eslint.workingDirectories": [
-		"./"
-	],
-	"typescript.validate.enable": true,
-	"editor.formatOnSave": false,
-	"editor.codeActionsOnSave": {
-		"source.fixAll.eslint": "always"
-	}
-}

package/.vscode/tasks.json

@@ -1,112 +0,0 @@
-{
-    "version": "2.0.0",
-    "tasks": [
-        {
-            "type": "npm",
-            "script": "watch.build.dev",
-            "group": "build",
-            "label": "watch.build.dev & problem.watcher",
-            "isBackground": true,
-            "runOptions": {
-                "runOn": "folderOpen"
-            },
-            "promptOnClose": false,
-            "presentation": {
-                "focus": false,
-                "reveal": "never"
-            },
-            "problemMatcher": {
-                "base": "$tsc-watch",
-                "applyTo": "allDocuments"
-            }
-        },
-        {
-            "label": "test.file",
-            "command": "spruce",
-            "args": [
-                "test",
-                "--inspect",
-                "5200",
-                "--pattern",
-                "${fileBasenameNoExtension}",
-                "--watchMode",
-                "standard"
-            ],
-            "promptOnClose": false,
-            "group": {
-                "kind": "test",
-                "isDefault": true
-            },
-            "presentation": {
-                "reveal": "always",
-                "panel": "dedicated",
-            },
-            "problemMatcher": []
-        },
-        {
-            "label": "test.reporter",
-            "command": "spruce",
-            "args": [
-                "test",
-                "--shouldHoldAtStart",
-                "true",
-                "--watchMode",
-                "smart"
-            ],
-            "promptOnClose": false,
-            "group": "test",
-            "runOptions": {
-                "runOn": "folderOpen"
-            },
-            "presentation": {
-                "panel": "shared",
-                "focus": true,
-                "reveal": "always"
-            }
-        },
-        {
-            "label": "spruce",
-            "type": "shell",
-            "command": "spruce ${input:spruceCommand}",
-            "problemMatcher": [],
-            "presentation": {
-                "reveal": "always",
-                "focus": true,
-                "panel": "new",
-                "clear": false
-            }
-        },
-        {
-            "label": "shell",
-            "type": "shell",
-            "command": "${input:command} ${input:optionsCommand}",
-            "problemMatcher": [],
-            "presentation": {
-                "reveal": "always",
-                "focus": true,
-                "panel": "new",
-                "clear": false
-            }
-        }
-    ],
-    "inputs": [
-        {
-            "id": "spruceCommand",
-            "description": "spruce command",
-            "default": "create.test",
-            "type": "promptString"
-        },
-        {
-            "id": "command",
-            "description": "command",
-            "default": "yarn",
-            "type": "promptString"
-        },
-        {
-            "id": "optionsCommand",
-            "description": "optionsCommand",
-            "default": "add",
-            "type": "promptString"
-        }
-    ]
-}

package/eslint.config.mjs

@@ -1,3 +0,0 @@
-import eslintConfigSpruce from 'eslint-config-spruce'
-
-export default eslintConfigSpruce

package/src/.spruce/errors/errors.types.ts

@@ -1,29 +0,0 @@
-import { default as SchemaEntity } from '@sprucelabs/schema'
-import * as SpruceSchema from '@sprucelabs/schema'
-
-
-
-
-
-export declare namespace SpruceErrors.SpruceAgentUtils {
-
-	
-	export interface AgentLoaderNotConfigured {
-		
-	}
-
-	export interface AgentLoaderNotConfiguredSchema extends SpruceSchema.Schema {
-		id: 'agentLoaderNotConfigured',
-		namespace: 'SpruceAgentUtils',
-		name: 'agent loader not configured',
-		    fields: {
-		    }
-	}
-
-	export type AgentLoaderNotConfiguredEntity = SchemaEntity<SpruceErrors.SpruceAgentUtils.AgentLoaderNotConfiguredSchema>
-
-}
-
-
-
-

package/src/.spruce/errors/options.types.ts

@@ -1,10 +0,0 @@
-import { SpruceErrors } from "#spruce/errors/errors.types"
-import { ErrorOptions as ISpruceErrorOptions} from "@sprucelabs/error"
-
-export interface AgentLoaderNotConfiguredErrorOptions extends SpruceErrors.SpruceAgentUtils.AgentLoaderNotConfigured, ISpruceErrorOptions {
-	code: 'AGENT_LOADER_NOT_CONFIGURED'
-}
-
-type ErrorOptions =  | AgentLoaderNotConfiguredErrorOptions 
-
-export default ErrorOptions

package/src/.spruce/errors/spruceAgentUtils/agentLoaderNotConfigured.schema.ts

@@ -1,16 +0,0 @@
-import { SchemaRegistry } from '@sprucelabs/schema'
-import { SpruceErrors } from '../errors.types'
-
-
-
-const agentLoaderNotConfiguredSchema: SpruceErrors.SpruceAgentUtils.AgentLoaderNotConfiguredSchema  = {
-	id: 'agentLoaderNotConfigured',
-	namespace: 'SpruceAgentUtils',
-	name: 'agent loader not configured',
-	    fields: {
-	    }
-}
-
-SchemaRegistry.getInstance().trackSchema(agentLoaderNotConfiguredSchema)
-
-export default agentLoaderNotConfiguredSchema

package/src/.spruce/schemas/fields/fieldClassMap.ts

@@ -1,6 +0,0 @@
-import { fieldClassMap } from '@sprucelabs/schema'
-
-
-
-
-export default fieldClassMap

package/src/SpruceAgent.ts

@@ -1,40 +0,0 @@
-import { MercuryClient } from '@sprucelabs/mercury-client'
-import SpruceError from './errors/SpruceError'
-
-export default class SpruceAgent implements AgentLoader {
-    private static instance?: SpruceAgent
-    private client: MercuryClient
-
-    private constructor(client: MercuryClient) {
-        this.client = client
-    }
-
-    public static setup(client: MercuryClient) {
-        this.instance = new SpruceAgent(client)
-    }
-
-    public static reset() {
-        delete this.instance
-    }
-
-    public static getInstance() {
-        if (this.instance) {
-            return this.instance
-        }
-        throw new SpruceError({
-            code: 'AGENT_LOADER_NOT_CONFIGURED',
-        })
-    }
-
-    public async getName() {
-        const [{ name }] = await this.client.emitAndFlattenResponses(
-            'get-agent-name::v2020_12_25'
-        )
-
-        return name
-    }
-}
-
-export interface AgentLoader {
-    getName(): Promise<string>
-}

package/src/__tests__/behavioral/AgentLoader.test.ts

@@ -1,53 +0,0 @@
-import {
-    AbstractSpruceFixtureTest,
-    eventFaker,
-    fake,
-} from '@sprucelabs/spruce-test-fixtures'
-import {
-    test,
-    suite,
-    assert,
-    errorAssert,
-    generateId,
-} from '@sprucelabs/test-utils'
-import SpruceAgent from '../../SpruceAgent'
-
-@fake.login()
-@suite()
-export default class AgentLoaderTest extends AbstractSpruceFixtureTest {
-    private agents!: SpruceAgent
-    private agentName = generateId()
-
-    protected async beforeEach(): Promise<void> {
-        await super.beforeEach()
-        SpruceAgent.setup(this.fakedClient)
-        this.agents = SpruceAgent.getInstance()
-    }
-
-    @test()
-    protected async getInstanceThrowsWithoutConfiguring() {
-        SpruceAgent.reset()
-        const err = assert.doesThrow(() => SpruceAgent.getInstance())
-        errorAssert.assertError(err, 'AGENT_LOADER_NOT_CONFIGURED')
-    }
-
-    @test()
-    protected async getInstanceReturnsSameInstanceEachTime() {
-        assert.isEqual(
-            this.agents,
-            SpruceAgent.getInstance(),
-            'should be the same instance'
-        )
-    }
-
-    @test()
-    protected async emitsGetAgentOnEmit() {
-        await eventFaker.on('get-agent-name::v2020_12_25', () => {
-            return { name: this.agentName }
-        })
-
-        const name = await this.agents.getName()
-
-        assert.isEqual(name, this.agentName, 'agent name does not match')
-    }
-}

package/src/__tests__/behavioral/TestingAgentLoader.test.ts

@@ -1,74 +0,0 @@
-import { fake } from '@sprucelabs/spruce-test-fixtures'
-import { AbstractSpruceFixtureTest } from '@sprucelabs/spruce-test-fixtures'
-import { test, suite, assert, errorAssert } from '@sprucelabs/test-utils'
-import agentAssert from '../../agentAssert'
-import SpruceAgent from '../../SpruceAgent'
-
-@fake.login()
-@suite()
-export default class TestingAgentLoaderTest extends AbstractSpruceFixtureTest {
-    @test()
-    protected async throwsIfDidNotBeforeEach() {
-        assert.doesThrow(() => agentAssert.getName(), 'beforeEach')
-    }
-
-    @test()
-    protected async throwsAgentLoaderNotConfiguredIfGettingNameBeforeConfigured() {
-        await agentAssert.beforeEach(this.fakedClient)
-        const err = assert.doesThrow(() => agentAssert.getName())
-
-        errorAssert.assertError(err, 'AGENT_LOADER_NOT_CONFIGURED')
-    }
-
-    @test()
-    protected async nameMatchesNameFromAgent() {
-        await this.fullBeforeEach()
-        const actual = agentAssert.getName()
-        const expected = await SpruceAgent.getInstance().getName()
-        assert.isEqual(
-            actual,
-            expected,
-            'agentAssert should return the same name as SpruceAgent'
-        )
-    }
-
-    @test()
-    protected async nameShouldDifferEachTest() {
-        await agentAssert.beforeEach(this.fakedClient)
-        const name1 = agentAssert.getName()
-        await agentAssert.beforeEach(this.fakedClient)
-        const name2 = agentAssert.getName()
-
-        assert.isNotEqual(name1, name2, 'names should differ between tests')
-    }
-
-    @test()
-    protected async assertIncludesAgentNameThrowsWithMissing() {
-        await this.fullBeforeEach()
-
-        //@ts-ignore
-        const err = assert.doesThrow(() => agentAssert.includesAgentName())
-        errorAssert.assertError(err, 'MISSING_PARAMETERS', {
-            parameters: ['text'],
-        })
-    }
-
-    @test()
-    protected async canAssertIncludesName() {
-        await this.fullBeforeEach()
-
-        const includesName = `Hello, my agent name is ${await SpruceAgent.getInstance().getName()}!`
-        const doesNotIncludeName = `Hello, I have no agent name!`
-
-        agentAssert.includesAgentName(includesName)
-
-        assert.doesThrow(() =>
-            agentAssert.includesAgentName(doesNotIncludeName)
-        )
-    }
-
-    private async fullBeforeEach() {
-        await agentAssert.beforeEach(this.fakedClient)
-        SpruceAgent.setup(this.fakedClient)
-    }
-}

package/src/agentAssert.ts

@@ -1,35 +0,0 @@
-import { MercuryClient } from '@sprucelabs/mercury-client'
-import { assertOptions } from '@sprucelabs/schema'
-import { eventFaker } from '@sprucelabs/spruce-test-fixtures'
-import { assert, generateId } from '@sprucelabs/test-utils'
-import SpruceAgent from './SpruceAgent'
-
-let sharedClient: MercuryClient
-let name: string = generateId()
-
-const agentAssert = {
-    async beforeEach(client: MercuryClient) {
-        name = generateId()
-        sharedClient = client
-        await eventFaker.on('get-agent-name::v2020_12_25', () => {
-            return { name }
-        })
-    },
-    getName: () => {
-        assert.isTruthy(
-            sharedClient,
-            'You must call agentAssert.beforeEach(this.fakedClient) in your test to use agentAssert'
-        )
-
-        SpruceAgent.getInstance()
-
-        return name
-    },
-
-    includesAgentName: (text: string) => {
-        assertOptions({ text }, ['text'])
-        assert.doesInclude(text, name, `The tex must include agent name!`)
-    },
-}
-
-export default agentAssert

package/src/errors/SpruceError.ts

@@ -1,23 +0,0 @@
-import BaseSpruceError from '@sprucelabs/error'
-import ErrorOptions from '#spruce/errors/options.types'
-
-export default class SpruceError extends BaseSpruceError<ErrorOptions> {
-    /** an easy to understand version of the errors */
-    public friendlyMessage(): string {
-        const { options } = this
-        let message
-        switch (options?.code) {
-            case 'AGENT_LOADER_NOT_CONFIGURED':
-                message = `The agent loader has not been configured. Please call AgentLoader.setup(...) first. Best place is probably in the did-boot of your skill.`
-                break
-            default:
-                message = super.friendlyMessage()
-        }
-
-        const fullMessage = options.friendlyMessage
-            ? options.friendlyMessage
-            : message
-
-        return fullMessage
-    }
-}

package/src/index.ts

@@ -1,3 +0,0 @@
-export { default as SpruceAgent } from './SpruceAgent'
-export * from './SpruceAgent'
-export { default as agentAssert } from './agentAssert'

package/tsconfig.json

@@ -1,39 +0,0 @@
-{
-	"compilerOptions": {
-		"skipLibCheck": true,
-		"module": "commonjs",
-		"esModuleInterop": true,
-		"target": "ES2020",
-		"lib": [
-			"DOM",
-			"ES2022"
-		],
-		"declaration": true,
-		"noImplicitAny": true,
-		"allowJs": true,
-		"forceConsistentCasingInFileNames": true,
-		"noImplicitReturns": true,
-		"strict": true,
-		"noUnusedLocals": true,
-		"resolveJsonModule": true,
-		"moduleResolution": "node",
-		"sourceMap": false,
-		"outDir": "build",
-		"baseUrl": "src",
-		"experimentalDecorators": true,
-		"paths": {
-			"#spruce/*": [
-				".spruce/*"
-			]
-		}
-	},
-	"include": [
-		"./src/*.ts",
-		"./src/**/*.ts",
-		"./src/.spruce/**/*"
-	],
-	"exclude": [
-		"build",
-		"esm"
-	]
-}