@settlemint/sdk-utils 2.3.2-pr6cb5dd2e → 2.3.2-pr74f654b5

package/README.md

@@ -39,6 +39,7 @@
     - [ensureServer()](#ensureserver)
     - [executeCommand()](#executecommand)
     - [exists()](#exists)
+    - [extractBaseUrlBeforeSegment()](#extractbaseurlbeforesegment)
     - [extractJsonObject()](#extractjsonobject)
     - [fetchWithRetry()](#fetchwithretry)
     - [findMonoRepoPackages()](#findmonorepopackages)
@@ -91,6 +92,7 @@
     - [PersonalAccessTokenSchema](#personalaccesstokenschema)
     - [runsInBrowser](#runsinbrowser)
     - [runsOnServer](#runsonserver)
+    - [STANDALONE\_INSTANCE](#standalone_instance)
     - [UniqueNameSchema](#uniquenameschema)
     - [UrlOrPathSchema](#urlorpathschema)
     - [UrlPathSchema](#urlpathschema)
@@ -415,6 +417,38 @@ if (await exists('/path/to/file.txt')) {
 
 ***
 
+#### extractBaseUrlBeforeSegment()
+
+> **extractBaseUrlBeforeSegment**(`baseUrl`, `pathSegment`): `string`
+
+Defined in: [sdk/utils/src/url.ts:15](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/url.ts#L15)
+
+Extracts the base URL before a specific segment in a URL.
+
+##### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `baseUrl` | `string` | The base URL to extract the path from |
+| `pathSegment` | `string` | The path segment to start from |
+
+##### Returns
+
+`string`
+
+The base URL before the specified segment
+
+##### Example
+
+```typescript
+import { extractBaseUrlBeforeSegment } from "@settlemint/sdk-utils/url";
+
+const baseUrl = extractBaseUrlBeforeSegment("https://example.com/api/v1/subgraphs/name/my-subgraph", "/subgraphs");
+// Returns: "https://example.com/api/v1"
+```
+
+***
+
 #### extractJsonObject()
 
 > **extractJsonObject**\<`T`\>(`value`): `null` \| `T`
@@ -1174,7 +1208,7 @@ The fetch function
 
 > **retryWhenFailed**\<`T`\>(`fn`, `maxRetries`, `initialSleepTime`, `stopOnError?`): `Promise`\<`T`\>
 
-Defined in: [sdk/utils/src/retry.ts:14](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/retry.ts#L14)
+Defined in: [sdk/utils/src/retry.ts:16](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/retry.ts#L16)
 
 Retry a function when it fails.
 
@@ -1663,7 +1697,7 @@ Options for configuring the spinner behavior
 
 > **DotEnv** = `z.infer`\<*typeof* [`DotEnvSchema`](#dotenvschema)\>
 
-Defined in: [sdk/utils/src/validation/dot-env.schema.ts:101](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/validation/dot-env.schema.ts#L101)
+Defined in: [sdk/utils/src/validation/dot-env.schema.ts:106](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/validation/dot-env.schema.ts#L106)
 
 Type definition for the environment variables schema.
 
@@ -1673,7 +1707,7 @@ Type definition for the environment variables schema.
 
 > **DotEnvPartial** = `z.infer`\<*typeof* [`DotEnvSchemaPartial`](#dotenvschemapartial)\>
 
-Defined in: [sdk/utils/src/validation/dot-env.schema.ts:112](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/validation/dot-env.schema.ts#L112)
+Defined in: [sdk/utils/src/validation/dot-env.schema.ts:117](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/validation/dot-env.schema.ts#L117)
 
 Type definition for the partial environment variables schema.
 
@@ -1724,9 +1758,9 @@ Application access tokens start with 'sm_aat_' prefix.
 
 #### DotEnvSchema
 
-> `const` **DotEnvSchema**: `ZodObject`\<\{ `SETTLEMINT_ACCESS_TOKEN`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_ACCESSIBLE_PRIVATE_KEY`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_APPLICATION`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NETWORK`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NODE`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKSCOUT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_CUSTOM_DEPLOYMENT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HASURA`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HASURA_ADMIN_SECRET`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HASURA_DATABASE_URL`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HASURA_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HD_PRIVATE_KEY`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_INSTANCE`: `ZodDefault`\<`ZodString`\>; `SETTLEMINT_IPFS`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_IPFS_API_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_IPFS_GATEWAY_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_IPFS_PINNING_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_LOG_LEVEL`: `ZodDefault`\<`ZodEnum`\<\{ `debug`: `"debug"`; `error`: `"error"`; `info`: `"info"`; `none`: `"none"`; `warn`: `"warn"`; \}\>\>; `SETTLEMINT_MINIO`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_MINIO_ACCESS_KEY`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_MINIO_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_MINIO_SECRET_KEY`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_NEW_PROJECT_NAME`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_PORTAL`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_PORTAL_REST_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_PORTAL_WS_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_THEGRAPH`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS`: `ZodPipe`\<`ZodTransform`\<`null` \| `never`[], `unknown`\>, `ZodOptional`\<`ZodArray`\<`ZodString`\>\>\>; `SETTLEMINT_WORKSPACE`: `ZodOptional`\<`ZodString`\>; \}, `$strip`\>
+> `const` **DotEnvSchema**: `ZodObject`\<\{ `SETTLEMINT_ACCESS_TOKEN`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_ACCESSIBLE_PRIVATE_KEY`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_APPLICATION`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NETWORK`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NODE`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKSCOUT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_CUSTOM_DEPLOYMENT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HASURA`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HASURA_ADMIN_SECRET`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HASURA_DATABASE_URL`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HASURA_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HD_PRIVATE_KEY`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_INSTANCE`: `ZodDefault`\<`ZodUnion`\<readonly \[`ZodString`, `ZodLiteral`\<`"standalone"`\>\]\>\>; `SETTLEMINT_IPFS`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_IPFS_API_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_IPFS_GATEWAY_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_IPFS_PINNING_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_LOG_LEVEL`: `ZodDefault`\<`ZodEnum`\<\{ `debug`: `"debug"`; `error`: `"error"`; `info`: `"info"`; `none`: `"none"`; `warn`: `"warn"`; \}\>\>; `SETTLEMINT_MINIO`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_MINIO_ACCESS_KEY`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_MINIO_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_MINIO_SECRET_KEY`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_NEW_PROJECT_NAME`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_PORTAL`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_PORTAL_REST_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_PORTAL_WS_ENDPOINT`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_THEGRAPH`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH`: `ZodOptional`\<`ZodString`\>; `SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS`: `ZodPipe`\<`ZodTransform`\<`null` \| `never`[], `unknown`\>, `ZodOptional`\<`ZodArray`\<`ZodString`\>\>\>; `SETTLEMINT_WORKSPACE`: `ZodOptional`\<`ZodString`\>; \}, `$strip`\>
 
-Defined in: [sdk/utils/src/validation/dot-env.schema.ts:12](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/validation/dot-env.schema.ts#L12)
+Defined in: [sdk/utils/src/validation/dot-env.schema.ts:17](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/validation/dot-env.schema.ts#L17)
 
 Schema for validating environment variables used by the SettleMint SDK.
 Defines validation rules and types for configuration values like URLs,
@@ -1736,9 +1770,9 @@ access tokens, workspace names, and service endpoints.
 
 #### DotEnvSchemaPartial
 
-> `const` **DotEnvSchemaPartial**: `ZodObject`\<\{ `SETTLEMINT_ACCESS_TOKEN`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_ACCESSIBLE_PRIVATE_KEY`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_APPLICATION`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NETWORK`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NODE`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKSCOUT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_CUSTOM_DEPLOYMENT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HASURA`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HASURA_ADMIN_SECRET`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HASURA_DATABASE_URL`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HASURA_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HD_PRIVATE_KEY`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_INSTANCE`: `ZodOptional`\<`ZodDefault`\<`ZodString`\>\>; `SETTLEMINT_IPFS`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_IPFS_API_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_IPFS_GATEWAY_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_IPFS_PINNING_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_LOG_LEVEL`: `ZodOptional`\<`ZodDefault`\<`ZodEnum`\<\{ `debug`: `"debug"`; `error`: `"error"`; `info`: `"info"`; `none`: `"none"`; `warn`: `"warn"`; \}\>\>\>; `SETTLEMINT_MINIO`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_MINIO_ACCESS_KEY`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_MINIO_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_MINIO_SECRET_KEY`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_NEW_PROJECT_NAME`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_PORTAL`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_PORTAL_REST_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_PORTAL_WS_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_THEGRAPH`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS`: `ZodOptional`\<`ZodPipe`\<`ZodTransform`\<`null` \| `never`[], `unknown`\>, `ZodOptional`\<`ZodArray`\<`ZodString`\>\>\>\>; `SETTLEMINT_WORKSPACE`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; \}, `$strip`\>
+> `const` **DotEnvSchemaPartial**: `ZodObject`\<\{ `SETTLEMINT_ACCESS_TOKEN`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_ACCESSIBLE_PRIVATE_KEY`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_APPLICATION`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NETWORK`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NODE`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKSCOUT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_CUSTOM_DEPLOYMENT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HASURA`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HASURA_ADMIN_SECRET`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HASURA_DATABASE_URL`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HASURA_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HD_PRIVATE_KEY`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_INSTANCE`: `ZodOptional`\<`ZodDefault`\<`ZodUnion`\<readonly \[`ZodString`, `ZodLiteral`\<`"standalone"`\>\]\>\>\>; `SETTLEMINT_IPFS`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_IPFS_API_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_IPFS_GATEWAY_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_IPFS_PINNING_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_LOG_LEVEL`: `ZodOptional`\<`ZodDefault`\<`ZodEnum`\<\{ `debug`: `"debug"`; `error`: `"error"`; `info`: `"info"`; `none`: `"none"`; `warn`: `"warn"`; \}\>\>\>; `SETTLEMINT_MINIO`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_MINIO_ACCESS_KEY`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_MINIO_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_MINIO_SECRET_KEY`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_NEW_PROJECT_NAME`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_PORTAL`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_PORTAL_REST_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_PORTAL_WS_ENDPOINT`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_THEGRAPH`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; `SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS`: `ZodOptional`\<`ZodPipe`\<`ZodTransform`\<`null` \| `never`[], `unknown`\>, `ZodOptional`\<`ZodArray`\<`ZodString`\>\>\>\>; `SETTLEMINT_WORKSPACE`: `ZodOptional`\<`ZodOptional`\<`ZodString`\>\>; \}, `$strip`\>
 
-Defined in: [sdk/utils/src/validation/dot-env.schema.ts:107](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/validation/dot-env.schema.ts#L107)
+Defined in: [sdk/utils/src/validation/dot-env.schema.ts:112](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/validation/dot-env.schema.ts#L112)
 
 Partial version of the environment variables schema where all fields are optional.
 Useful for validating incomplete configurations during development or build time.
@@ -1800,6 +1834,16 @@ Boolean indicating if code is currently running in a server environment
 
 ***
 
+#### STANDALONE\_INSTANCE
+
+> `const` **STANDALONE\_INSTANCE**: `"standalone"` = `"standalone"`
+
+Defined in: [sdk/utils/src/validation/dot-env.schema.ts:10](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/utils/src/validation/dot-env.schema.ts#L10)
+
+Use this value to indicate that the resources are not part of the SettleMint platform.
+
+***
+
 #### UniqueNameSchema
 
 > `const` **UniqueNameSchema**: `ZodString`

package/dist/environment.cjs

@@ -1,421 +1,38 @@
-"use strict";
+//#region rolldown:runtime
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/environment.ts
-var environment_exports = {};
-__export(environment_exports, {
-  loadEnv: () => loadEnv,
-  writeEnv: () => writeEnv
-});
-module.exports = __toCommonJS(environment_exports);
-
-// src/environment/load-env.ts
-var import_node_path = require("path");
-
-// src/terminal/ascii.ts
-var import_yoctocolors = require("yoctocolors");
-
-// src/logging/mask-tokens.ts
-var maskTokens = (output) => {
-  return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, "***");
-};
-
-// src/terminal/cancel.ts
-var import_yoctocolors2 = require("yoctocolors");
-var CancelError = class extends Error {
-};
-var cancel = (msg) => {
-  console.log("");
-  console.log((0, import_yoctocolors2.inverse)((0, import_yoctocolors2.redBright)(maskTokens(msg))));
-  console.log("");
-  throw new CancelError(msg);
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
 
-// src/terminal/execute-command.ts
-var import_node_child_process = require("child_process");
-
-// src/terminal/intro.ts
-var import_yoctocolors3 = require("yoctocolors");
+//#endregion
+const src_environment_load_env_js = __toESM(require("./environment/load-env.js"));
+const src_environment_write_env_js = __toESM(require("./environment/write-env.js"));
 
-// src/terminal/note.ts
-var import_yoctocolors4 = require("yoctocolors");
-
-// src/terminal/outro.ts
-var import_yoctocolors5 = require("yoctocolors");
-
-// src/terminal/spinner.ts
-var import_is_in_ci = __toESM(require("is-in-ci"), 1);
-var import_yocto_spinner = __toESM(require("yocto-spinner"), 1);
-var import_yoctocolors6 = require("yoctocolors");
-
-// src/terminal/table.ts
-var import_console_table_printer = require("console-table-printer");
-var import_yoctocolors7 = require("yoctocolors");
-
-// src/validation/validate.ts
-var import_v4 = require("zod/v4");
-function validate(schema, value) {
-  try {
-    return schema.parse(value);
-  } catch (error) {
-    if (error instanceof import_v4.ZodError) {
-      const formattedErrors = error.issues.map((err) => `- ${err.path.join(".")}: ${err.message}`).join("\n");
-      throw new Error(`Validation error${error.issues.length > 1 ? "s" : ""}:
-${formattedErrors}`);
-    }
-    throw error;
+Object.defineProperty(exports, 'loadEnv', {
+  enumerable: true,
+  get: function () {
+    return src_environment_load_env_js.loadEnv;
   }
-}
-
-// src/validation/access-token.schema.ts
-var import_v42 = require("zod/v4");
-var ApplicationAccessTokenSchema = import_v42.z.string().regex(/^sm_aat_.*$/);
-var PersonalAccessTokenSchema = import_v42.z.string().regex(/^sm_pat_.*$/);
-var AccessTokenSchema = import_v42.z.string().regex(/^sm_pat_.*|sm_aat_.*$/);
-
-// src/json.ts
-function tryParseJson(value, defaultValue = null) {
-  try {
-    const parsed = JSON.parse(value);
-    if (parsed === void 0 || parsed === null) {
-      return defaultValue;
-    }
-    return parsed;
-  } catch (err) {
-    return defaultValue;
-  }
-}
-
-// src/validation/dot-env.schema.ts
-var import_v45 = require("zod/v4");
-
-// src/validation/unique-name.schema.ts
-var import_v43 = require("zod/v4");
-var UniqueNameSchema = import_v43.z.string().regex(/^[a-z0-9-]+$/);
-
-// src/validation/url.schema.ts
-var import_v44 = require("zod/v4");
-var UrlSchema = import_v44.z.string().url();
-var UrlPathSchema = import_v44.z.string().regex(/^\/(?:[a-zA-Z0-9-_]+(?:\/[a-zA-Z0-9-_]+)*\/?)?$/, {
-  message: "Invalid URL path format. Must start with '/' and can contain letters, numbers, hyphens, and underscores."
-});
-var UrlOrPathSchema = import_v44.z.union([UrlSchema, UrlPathSchema]);
-
-// src/validation/dot-env.schema.ts
-var DotEnvSchema = import_v45.z.object({
-  /** Base URL of the SettleMint platform instance */
-  SETTLEMINT_INSTANCE: UrlSchema.default("https://console.settlemint.com"),
-  /** Application access token for authenticating with SettleMint services */
-  SETTLEMINT_ACCESS_TOKEN: ApplicationAccessTokenSchema.optional(),
-  /** @internal */
-  SETTLEMINT_PERSONAL_ACCESS_TOKEN: PersonalAccessTokenSchema.optional(),
-  /** Unique name of the workspace */
-  SETTLEMINT_WORKSPACE: UniqueNameSchema.optional(),
-  /** Unique name of the application */
-  SETTLEMINT_APPLICATION: UniqueNameSchema.optional(),
-  /** Unique name of the blockchain network */
-  SETTLEMINT_BLOCKCHAIN_NETWORK: UniqueNameSchema.optional(),
-  /** Chain ID of the blockchain network */
-  SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID: import_v45.z.string().optional(),
-  /** Unique name of the blockchain node (should have a private key for signing transactions) */
-  SETTLEMINT_BLOCKCHAIN_NODE: UniqueNameSchema.optional(),
-  /** JSON RPC endpoint for the blockchain node */
-  SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT: UrlSchema.optional(),
-  /** Unique name of the blockchain node or load balancer */
-  SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER: UniqueNameSchema.optional(),
-  /** JSON RPC endpoint for the blockchain node or load balancer */
-  SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT: UrlSchema.optional(),
-  /** Unique name of the Hasura instance */
-  SETTLEMINT_HASURA: UniqueNameSchema.optional(),
-  /** Endpoint URL for the Hasura GraphQL API */
-  SETTLEMINT_HASURA_ENDPOINT: UrlSchema.optional(),
-  /** Admin secret for authenticating with Hasura */
-  SETTLEMINT_HASURA_ADMIN_SECRET: import_v45.z.string().optional(),
-  /** Database connection URL for Hasura */
-  SETTLEMINT_HASURA_DATABASE_URL: import_v45.z.string().optional(),
-  /** Unique name of The Graph instance */
-  SETTLEMINT_THEGRAPH: UniqueNameSchema.optional(),
-  /** Array of endpoint URLs for The Graph subgraphs */
-  SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS: import_v45.z.preprocess(
-    (value) => tryParseJson(value, []),
-    import_v45.z.array(UrlSchema).optional()
-  ),
-  /** Default The Graph subgraph to use */
-  SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH: import_v45.z.string().optional(),
-  /** Unique name of the Smart Contract Portal instance */
-  SETTLEMINT_PORTAL: UniqueNameSchema.optional(),
-  /** GraphQL endpoint URL for the Portal */
-  SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT: UrlSchema.optional(),
-  /** REST endpoint URL for the Portal */
-  SETTLEMINT_PORTAL_REST_ENDPOINT: UrlSchema.optional(),
-  /** WebSocket endpoint URL for the Portal */
-  SETTLEMINT_PORTAL_WS_ENDPOINT: UrlSchema.optional(),
-  /** Unique name of the HD private key */
-  SETTLEMINT_HD_PRIVATE_KEY: UniqueNameSchema.optional(),
-  /** Address of the HD private key forwarder */
-  SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS: import_v45.z.string().optional(),
-  /** Unique name of the accessible private key */
-  SETTLEMINT_ACCESSIBLE_PRIVATE_KEY: UniqueNameSchema.optional(),
-  /** Unique name of the MinIO instance */
-  SETTLEMINT_MINIO: UniqueNameSchema.optional(),
-  /** Endpoint URL for MinIO */
-  SETTLEMINT_MINIO_ENDPOINT: UrlSchema.optional(),
-  /** Access key for MinIO authentication */
-  SETTLEMINT_MINIO_ACCESS_KEY: import_v45.z.string().optional(),
-  /** Secret key for MinIO authentication */
-  SETTLEMINT_MINIO_SECRET_KEY: import_v45.z.string().optional(),
-  /** Unique name of the IPFS instance */
-  SETTLEMINT_IPFS: UniqueNameSchema.optional(),
-  /** API endpoint URL for IPFS */
-  SETTLEMINT_IPFS_API_ENDPOINT: UrlSchema.optional(),
-  /** Pinning service endpoint URL for IPFS */
-  SETTLEMINT_IPFS_PINNING_ENDPOINT: UrlSchema.optional(),
-  /** Gateway endpoint URL for IPFS */
-  SETTLEMINT_IPFS_GATEWAY_ENDPOINT: UrlSchema.optional(),
-  /** Unique name of the custom deployment */
-  SETTLEMINT_CUSTOM_DEPLOYMENT: UniqueNameSchema.optional(),
-  /** Endpoint URL for the custom deployment */
-  SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT: UrlSchema.optional(),
-  /** Unique name of the Blockscout instance */
-  SETTLEMINT_BLOCKSCOUT: UniqueNameSchema.optional(),
-  /** GraphQL endpoint URL for Blockscout */
-  SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT: UrlSchema.optional(),
-  /** UI endpoint URL for Blockscout */
-  SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT: UrlSchema.optional(),
-  /** Name of the new project being created */
-  SETTLEMINT_NEW_PROJECT_NAME: import_v45.z.string().optional(),
-  /** The log level to use */
-  SETTLEMINT_LOG_LEVEL: import_v45.z.enum(["debug", "info", "warn", "error", "none"]).default("warn")
 });
-var DotEnvSchemaPartial = DotEnvSchema.partial();
-
-// src/validation/id.schema.ts
-var import_v46 = require("zod/v4");
-var IdSchema = import_v46.z.union([
-  import_v46.z.string().uuid(),
-  // PostgreSQL UUID
-  import_v46.z.string().regex(/^[0-9a-fA-F]{24}$/)
-  // MongoDB ObjectID
-]);
-
-// src/environment/load-env.ts
-var import_dotenvx = require("@dotenvx/dotenvx");
-async function loadEnv(validateEnv, prod, path = process.cwd()) {
-  return loadEnvironmentEnv(validateEnv, !!prod, path);
-}
-async function loadEnvironmentEnv(validateEnv, prod, path = process.cwd()) {
-  if (prod) {
-    process.env.NODE_ENV = "production";
-  }
-  let { parsed } = (0, import_dotenvx.config)({
-    convention: "nextjs",
-    logLevel: "error",
-    overload: true,
-    quiet: true,
-    path: [(0, import_node_path.join)(path, ".env"), (0, import_node_path.join)(path, ".env.local")]
-  });
-  if (!parsed) {
-    parsed = {};
-  }
-  const defaultEnv = Object.fromEntries(
-    Object.entries(process.env).filter(([_, value]) => typeof value === "string" && value !== "")
-  );
-  try {
-    return validate(validateEnv ? DotEnvSchema : DotEnvSchemaPartial, {
-      ...parsed,
-      ...defaultEnv
-    });
-  } catch (error) {
-    cancel(error.message);
-    return {};
-  }
-}
-
-// src/environment/write-env.ts
-var import_promises3 = require("fs/promises");
-var import_node_path4 = require("path");
-
-// src/filesystem/project-root.ts
-var import_node_path2 = require("path");
-var import_find_up = require("find-up");
-async function projectRoot(fallbackToCwd = false, cwd) {
-  const packageJsonPath = await (0, import_find_up.findUp)("package.json", { cwd });
-  if (!packageJsonPath) {
-    if (fallbackToCwd) {
-      return process.cwd();
-    }
-    throw new Error("Unable to find project root (no package.json found)");
-  }
-  return (0, import_node_path2.dirname)(packageJsonPath);
-}
-
-// src/filesystem/exists.ts
-var import_promises = require("fs/promises");
-async function exists(path) {
-  try {
-    await (0, import_promises.stat)(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-// src/filesystem/mono-repo.ts
-var import_promises2 = require("fs/promises");
-var import_node_path3 = require("path");
-var import_find_up2 = require("find-up");
-var import_glob = require("glob");
-async function findMonoRepoRoot(startDir) {
-  const lockFilePath = await (0, import_find_up2.findUp)(["package-lock.json", "yarn.lock", "pnpm-lock.yaml", "bun.lockb", "bun.lock"], {
-    cwd: startDir
-  });
-  if (lockFilePath) {
-    const packageJsonPath = (0, import_node_path3.join)((0, import_node_path3.dirname)(lockFilePath), "package.json");
-    const hasWorkSpaces = await packageJsonHasWorkspaces(packageJsonPath);
-    return hasWorkSpaces ? (0, import_node_path3.dirname)(lockFilePath) : null;
+Object.defineProperty(exports, 'writeEnv', {
+  enumerable: true,
+  get: function () {
+    return src_environment_write_env_js.writeEnv;
   }
-  let currentDir = startDir;
-  while (currentDir !== "/") {
-    const packageJsonPath = (0, import_node_path3.join)(currentDir, "package.json");
-    if (await packageJsonHasWorkspaces(packageJsonPath)) {
-      return currentDir;
-    }
-    const parentDir = (0, import_node_path3.dirname)(currentDir);
-    if (parentDir === currentDir) {
-      break;
-    }
-    currentDir = parentDir;
-  }
-  return null;
-}
-async function findMonoRepoPackages(projectDir) {
-  try {
-    const monoRepoRoot = await findMonoRepoRoot(projectDir);
-    if (!monoRepoRoot) {
-      return [projectDir];
-    }
-    const packageJsonPath = (0, import_node_path3.join)(monoRepoRoot, "package.json");
-    const packageJson = tryParseJson(await (0, import_promises2.readFile)(packageJsonPath, "utf-8"));
-    const workspaces = packageJson?.workspaces ?? [];
-    const packagePaths = await Promise.all(
-      workspaces.map(async (workspace) => {
-        const matches = await (0, import_glob.glob)((0, import_node_path3.join)(monoRepoRoot, workspace, "package.json"));
-        return matches.map((match) => (0, import_node_path3.join)(match, ".."));
-      })
-    );
-    const allPaths = packagePaths.flat();
-    return allPaths.length === 0 ? [projectDir] : [monoRepoRoot, ...allPaths];
-  } catch (error) {
-    return [projectDir];
-  }
-}
-async function packageJsonHasWorkspaces(packageJsonPath) {
-  if (await exists(packageJsonPath)) {
-    const packageJson = tryParseJson(await (0, import_promises2.readFile)(packageJsonPath, "utf-8"));
-    if (packageJson?.workspaces && Array.isArray(packageJson?.workspaces) && packageJson?.workspaces.length > 0) {
-      return true;
-    }
-  }
-  return false;
-}
-
-// src/environment/write-env.ts
-var import_dotenvx2 = require("@dotenvx/dotenvx");
-var import_deepmerge_ts = require("deepmerge-ts");
-async function writeEnv({
-  prod,
-  env,
-  secrets,
-  cwd
-}) {
-  const projectDir = await projectRoot(true, cwd);
-  if (prod) {
-    process.env.NODE_ENV = "production";
-  }
-  const targetDirs = await findMonoRepoPackages(projectDir);
-  await Promise.all(
-    targetDirs.map(async (dir) => {
-      const envFile = (0, import_node_path4.join)(
-        dir,
-        secrets ? `.env${prod ? ".production" : ""}.local` : `.env${prod ? ".production" : ""}`
-      );
-      let { parsed: currentEnv } = await exists(envFile) ? (0, import_dotenvx2.config)({
-        path: envFile,
-        logLevel: "error",
-        quiet: true
-      }) : { parsed: {} };
-      if (!currentEnv) {
-        currentEnv = {};
-      }
-      const prunedEnv = pruneCurrentEnv(currentEnv, env);
-      const mergedEnv = (0, import_deepmerge_ts.deepmerge)(prunedEnv, env);
-      await (0, import_promises3.writeFile)(envFile, stringify(mergedEnv));
-    })
-  );
-}
-var quote = /[\s"'#]/;
-function stringifyPair([key, val]) {
-  if (val === void 0) {
-    return void 0;
-  }
-  if (val === null) {
-    return `${key}=""`;
-  }
-  const type = typeof val;
-  if (type === "string") {
-    return `${key}=${quote.test(val) ? JSON.stringify(val) : val}`;
-  }
-  if (type === "boolean" || type === "number") {
-    return `${key}=${val}`;
-  }
-  if (type === "object") {
-    return `${key}=${JSON.stringify(val)}`;
-  }
-  throw new Error(`Unsupported type for key "${key}": ${type}`);
-}
-function stringify(obj) {
-  return Object.entries(obj).sort(([a], [b]) => a.localeCompare(b)).map(stringifyPair).filter((value) => value !== void 0).join("\n");
-}
-function pruneCurrentEnv(currentEnv, env) {
-  const dotEnvKeys = Object.keys(DotEnvSchema.shape);
-  return Object.fromEntries(
-    Object.entries(currentEnv).filter(([key]) => {
-      if (dotEnvKeys.includes(key) && !env[key]) {
-        return false;
-      }
-      return true;
-    })
-  );
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  loadEnv,
-  writeEnv
-});
-//# sourceMappingURL=environment.cjs.map
+});