@settlemint/sdk-utils 2.3.1 → 2.3.2-main3c010da3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. package/README.md +132 -287
  2. package/dist/environment.cjs +17708 -383
  3. package/dist/environment.cjs.map +1 -1
  4. package/dist/environment.d.cts +265 -292
  5. package/dist/environment.d.ts +265 -292
  6. package/dist/environment.js +17746 -0
  7. package/dist/environment.js.map +1 -0
  8. package/dist/filesystem.cjs +6746 -113
  9. package/dist/filesystem.cjs.map +1 -1
  10. package/dist/filesystem.d.cts +22 -1
  11. package/dist/filesystem.d.ts +22 -1
  12. package/dist/filesystem.js +6766 -0
  13. package/dist/filesystem.js.map +1 -0
  14. package/dist/http.cjs +217 -79
  15. package/dist/http.cjs.map +1 -1
  16. package/dist/http.d.cts +14 -1
  17. package/dist/http.d.ts +14 -1
  18. package/dist/http.js +226 -0
  19. package/dist/http.js.map +1 -0
  20. package/dist/index.cjs +295 -104
  21. package/dist/index.cjs.map +1 -1
  22. package/dist/index.d.cts +26 -1
  23. package/dist/index.d.ts +26 -1
  24. package/dist/index.js +306 -0
  25. package/dist/index.js.map +1 -0
  26. package/dist/json.cjs +83 -0
  27. package/dist/json.cjs.map +1 -0
  28. package/dist/json.d.cts +56 -0
  29. package/dist/json.d.ts +56 -0
  30. package/dist/json.js +80 -0
  31. package/dist/json.js.map +1 -0
  32. package/dist/logging.cjs +209 -137
  33. package/dist/logging.cjs.map +1 -1
  34. package/dist/logging.d.cts +23 -14
  35. package/dist/logging.d.ts +23 -14
  36. package/dist/logging.js +221 -0
  37. package/dist/logging.js.map +1 -0
  38. package/dist/package-manager.cjs +7353 -173
  39. package/dist/package-manager.cjs.map +1 -1
  40. package/dist/package-manager.d.cts +26 -3
  41. package/dist/package-manager.d.ts +26 -3
  42. package/dist/package-manager.js +7385 -0
  43. package/dist/package-manager.js.map +1 -0
  44. package/dist/retry.cjs +137 -0
  45. package/dist/retry.cjs.map +1 -0
  46. package/dist/retry.d.cts +19 -0
  47. package/dist/retry.d.ts +19 -0
  48. package/dist/retry.js +136 -0
  49. package/dist/retry.js.map +1 -0
  50. package/dist/runtime.cjs +58 -40
  51. package/dist/runtime.cjs.map +1 -1
  52. package/dist/runtime.d.cts +3 -0
  53. package/dist/runtime.d.ts +3 -0
  54. package/dist/runtime.js +45 -0
  55. package/dist/runtime.js.map +1 -0
  56. package/dist/string.cjs +76 -0
  57. package/dist/string.cjs.map +1 -0
  58. package/dist/string.d.cts +58 -0
  59. package/dist/string.d.ts +58 -0
  60. package/dist/string.js +72 -0
  61. package/dist/string.js.map +1 -0
  62. package/dist/terminal.cjs +426 -229
  63. package/dist/terminal.cjs.map +1 -1
  64. package/dist/terminal.d.cts +54 -24
  65. package/dist/terminal.d.ts +54 -24
  66. package/dist/terminal.js +441 -0
  67. package/dist/terminal.js.map +1 -0
  68. package/dist/url.cjs +25 -0
  69. package/dist/url.cjs.map +1 -0
  70. package/dist/url.d.cts +20 -0
  71. package/dist/url.d.ts +20 -0
  72. package/dist/url.js +24 -0
  73. package/dist/url.js.map +1 -0
  74. package/dist/validation.cjs +10486 -190
  75. package/dist/validation.cjs.map +1 -1
  76. package/dist/validation.d.cts +133 -291
  77. package/dist/validation.d.ts +133 -291
  78. package/dist/validation.js +10482 -0
  79. package/dist/validation.js.map +1 -0
  80. package/package.json +6 -6
  81. package/dist/environment.mjs +0 -383
  82. package/dist/environment.mjs.map +0 -1
  83. package/dist/filesystem.mjs +0 -105
  84. package/dist/filesystem.mjs.map +0 -1
  85. package/dist/http.mjs +0 -63
  86. package/dist/http.mjs.map +0 -1
  87. package/dist/index.mjs +0 -90
  88. package/dist/index.mjs.map +0 -1
  89. package/dist/logging.mjs +0 -123
  90. package/dist/logging.mjs.map +0 -1
  91. package/dist/package-manager.mjs +0 -167
  92. package/dist/package-manager.mjs.map +0 -1
  93. package/dist/runtime.mjs +0 -23
  94. package/dist/runtime.mjs.map +0 -1
  95. package/dist/terminal.mjs +0 -230
  96. package/dist/terminal.mjs.map +0 -1
  97. package/dist/validation.mjs +0 -159
  98. package/dist/validation.mjs.map +0 -1
@@ -1,174 +1,114 @@
1
- import { z } from 'zod';
1
+ import { ZodString, ZodType, z } from "zod/v4";
2
2
 
3
+ //#region src/validation/validate.d.ts
4
+ /**
5
+ * Validates a value against a given Zod schema.
6
+ *
7
+ * @param schema - The Zod schema to validate against.
8
+ * @param value - The value to validate.
9
+ * @returns The validated and parsed value.
10
+ * @throws Will throw an error if validation fails, with formatted error messages.
11
+ *
12
+ * @example
13
+ * import { validate } from "@settlemint/sdk-utils/validation";
14
+ *
15
+ * const validatedId = validate(IdSchema, "550e8400-e29b-41d4-a716-446655440000");
16
+ */
17
+ /**
18
+ * Validates a value against a given Zod schema.
19
+ *
20
+ * @param schema - The Zod schema to validate against.
21
+ * @param value - The value to validate.
22
+ * @returns The validated and parsed value.
23
+ * @throws Will throw an error if validation fails, with formatted error messages.
24
+ *
25
+ * @example
26
+ * import { validate } from "@settlemint/sdk-utils/validation";
27
+ *
28
+ * const validatedId = validate(IdSchema, "550e8400-e29b-41d4-a716-446655440000");
29
+ */
30
+ declare function validate<T extends ZodType>(schema: T, value: unknown): T["_output"];
31
+
32
+ //#endregion
33
+ //#region src/validation/access-token.schema.d.ts
34
+ /**
35
+ * Schema for validating application access tokens.
36
+ * Application access tokens start with 'sm_aat_' prefix.
37
+ */
38
+ declare const ApplicationAccessTokenSchema: ZodString;
39
+ type ApplicationAccessToken = z.infer<typeof ApplicationAccessTokenSchema>;
40
+ /**
41
+ * Schema for validating personal access tokens.
42
+ * Personal access tokens start with 'sm_pat_' prefix.
43
+ */
44
+ declare const PersonalAccessTokenSchema: ZodString;
45
+ type PersonalAccessToken = z.infer<typeof PersonalAccessTokenSchema>;
46
+ /**
47
+ * Schema for validating both application and personal access tokens.
48
+ * Accepts tokens starting with either 'sm_pat_' or 'sm_aat_' prefix.
49
+ */
50
+ declare const AccessTokenSchema: ZodString;
51
+ type AccessToken = z.infer<typeof AccessTokenSchema>;
52
+
53
+ //#endregion
54
+ //#region src/validation/dot-env.schema.d.ts
55
+ /**
56
+ * Use this value to indicate that the resources are not part of the SettleMint platform.
57
+ */
58
+ declare const STANDALONE_INSTANCE = "standalone";
3
59
  /**
4
60
  * Schema for validating environment variables used by the SettleMint SDK.
5
61
  * Defines validation rules and types for configuration values like URLs,
6
62
  * access tokens, workspace names, and service endpoints.
7
63
  */
8
64
  declare const DotEnvSchema: z.ZodObject<{
9
- /** Base URL of the SettleMint platform instance */
10
- SETTLEMINT_INSTANCE: z.ZodDefault<z.ZodString>;
11
- /** Application access token for authenticating with SettleMint services */
12
- SETTLEMINT_ACCESS_TOKEN: z.ZodOptional<z.ZodString>;
13
- /** @internal */
14
- SETTLEMINT_PERSONAL_ACCESS_TOKEN: z.ZodOptional<z.ZodString>;
15
- /** Unique name of the workspace */
16
- SETTLEMINT_WORKSPACE: z.ZodOptional<z.ZodString>;
17
- /** Unique name of the application */
18
- SETTLEMINT_APPLICATION: z.ZodOptional<z.ZodString>;
19
- /** Unique name of the blockchain network */
20
- SETTLEMINT_BLOCKCHAIN_NETWORK: z.ZodOptional<z.ZodString>;
21
- /** Chain ID of the blockchain network */
22
- SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID: z.ZodOptional<z.ZodString>;
23
- /** Unique name of the blockchain node (should have a private key for signing transactions) */
24
- SETTLEMINT_BLOCKCHAIN_NODE: z.ZodOptional<z.ZodString>;
25
- /** JSON RPC endpoint for the blockchain node */
26
- SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT: z.ZodOptional<z.ZodString>;
27
- /** Unique name of the blockchain node or load balancer */
28
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER: z.ZodOptional<z.ZodString>;
29
- /** JSON RPC endpoint for the blockchain node or load balancer */
30
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT: z.ZodOptional<z.ZodString>;
31
- /** Unique name of the Hasura instance */
32
- SETTLEMINT_HASURA: z.ZodOptional<z.ZodString>;
33
- /** Endpoint URL for the Hasura GraphQL API */
34
- SETTLEMINT_HASURA_ENDPOINT: z.ZodOptional<z.ZodString>;
35
- /** Admin secret for authenticating with Hasura */
36
- SETTLEMINT_HASURA_ADMIN_SECRET: z.ZodOptional<z.ZodString>;
37
- /** Database connection URL for Hasura */
38
- SETTLEMINT_HASURA_DATABASE_URL: z.ZodOptional<z.ZodString>;
39
- /** Unique name of The Graph instance */
40
- SETTLEMINT_THEGRAPH: z.ZodOptional<z.ZodString>;
41
- /** Array of endpoint URLs for The Graph subgraphs */
42
- SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS: z.ZodEffects<z.ZodOptional<z.ZodArray<z.ZodString, "many">>, string[] | undefined, unknown>;
43
- /** Default The Graph subgraph to use */
44
- SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH: z.ZodOptional<z.ZodString>;
45
- /** Unique name of the Smart Contract Portal instance */
46
- SETTLEMINT_PORTAL: z.ZodOptional<z.ZodString>;
47
- /** GraphQL endpoint URL for the Portal */
48
- SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT: z.ZodOptional<z.ZodString>;
49
- /** REST endpoint URL for the Portal */
50
- SETTLEMINT_PORTAL_REST_ENDPOINT: z.ZodOptional<z.ZodString>;
51
- /** WebSocket endpoint URL for the Portal */
52
- SETTLEMINT_PORTAL_WS_ENDPOINT: z.ZodOptional<z.ZodString>;
53
- /** Unique name of the HD private key */
54
- SETTLEMINT_HD_PRIVATE_KEY: z.ZodOptional<z.ZodString>;
55
- /** Address of the HD private key forwarder */
56
- SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS: z.ZodOptional<z.ZodString>;
57
- /** Unique name of the accessible private key */
58
- SETTLEMINT_ACCESSIBLE_PRIVATE_KEY: z.ZodOptional<z.ZodString>;
59
- /** Unique name of the MinIO instance */
60
- SETTLEMINT_MINIO: z.ZodOptional<z.ZodString>;
61
- /** Endpoint URL for MinIO */
62
- SETTLEMINT_MINIO_ENDPOINT: z.ZodOptional<z.ZodString>;
63
- /** Access key for MinIO authentication */
64
- SETTLEMINT_MINIO_ACCESS_KEY: z.ZodOptional<z.ZodString>;
65
- /** Secret key for MinIO authentication */
66
- SETTLEMINT_MINIO_SECRET_KEY: z.ZodOptional<z.ZodString>;
67
- /** Unique name of the IPFS instance */
68
- SETTLEMINT_IPFS: z.ZodOptional<z.ZodString>;
69
- /** API endpoint URL for IPFS */
70
- SETTLEMINT_IPFS_API_ENDPOINT: z.ZodOptional<z.ZodString>;
71
- /** Pinning service endpoint URL for IPFS */
72
- SETTLEMINT_IPFS_PINNING_ENDPOINT: z.ZodOptional<z.ZodString>;
73
- /** Gateway endpoint URL for IPFS */
74
- SETTLEMINT_IPFS_GATEWAY_ENDPOINT: z.ZodOptional<z.ZodString>;
75
- /** Unique name of the custom deployment */
76
- SETTLEMINT_CUSTOM_DEPLOYMENT: z.ZodOptional<z.ZodString>;
77
- /** Endpoint URL for the custom deployment */
78
- SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT: z.ZodOptional<z.ZodString>;
79
- /** Unique name of the Blockscout instance */
80
- SETTLEMINT_BLOCKSCOUT: z.ZodOptional<z.ZodString>;
81
- /** GraphQL endpoint URL for Blockscout */
82
- SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT: z.ZodOptional<z.ZodString>;
83
- /** UI endpoint URL for Blockscout */
84
- SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT: z.ZodOptional<z.ZodString>;
85
- /** Name of the new project being created */
86
- SETTLEMINT_NEW_PROJECT_NAME: z.ZodOptional<z.ZodString>;
87
- /** The log level to use */
88
- SETTLEMINT_LOG_LEVEL: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error", "none"]>>;
89
- }, "strip", z.ZodTypeAny, {
90
- SETTLEMINT_INSTANCE: string;
91
- SETTLEMINT_LOG_LEVEL: "error" | "info" | "warn" | "debug" | "none";
92
- SETTLEMINT_ACCESS_TOKEN?: string | undefined;
93
- SETTLEMINT_PERSONAL_ACCESS_TOKEN?: string | undefined;
94
- SETTLEMINT_WORKSPACE?: string | undefined;
95
- SETTLEMINT_APPLICATION?: string | undefined;
96
- SETTLEMINT_BLOCKCHAIN_NETWORK?: string | undefined;
97
- SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID?: string | undefined;
98
- SETTLEMINT_BLOCKCHAIN_NODE?: string | undefined;
99
- SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT?: string | undefined;
100
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER?: string | undefined;
101
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT?: string | undefined;
102
- SETTLEMINT_HASURA?: string | undefined;
103
- SETTLEMINT_HASURA_ENDPOINT?: string | undefined;
104
- SETTLEMINT_HASURA_ADMIN_SECRET?: string | undefined;
105
- SETTLEMINT_HASURA_DATABASE_URL?: string | undefined;
106
- SETTLEMINT_THEGRAPH?: string | undefined;
107
- SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS?: string[] | undefined;
108
- SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH?: string | undefined;
109
- SETTLEMINT_PORTAL?: string | undefined;
110
- SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT?: string | undefined;
111
- SETTLEMINT_PORTAL_REST_ENDPOINT?: string | undefined;
112
- SETTLEMINT_PORTAL_WS_ENDPOINT?: string | undefined;
113
- SETTLEMINT_HD_PRIVATE_KEY?: string | undefined;
114
- SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS?: string | undefined;
115
- SETTLEMINT_ACCESSIBLE_PRIVATE_KEY?: string | undefined;
116
- SETTLEMINT_MINIO?: string | undefined;
117
- SETTLEMINT_MINIO_ENDPOINT?: string | undefined;
118
- SETTLEMINT_MINIO_ACCESS_KEY?: string | undefined;
119
- SETTLEMINT_MINIO_SECRET_KEY?: string | undefined;
120
- SETTLEMINT_IPFS?: string | undefined;
121
- SETTLEMINT_IPFS_API_ENDPOINT?: string | undefined;
122
- SETTLEMINT_IPFS_PINNING_ENDPOINT?: string | undefined;
123
- SETTLEMINT_IPFS_GATEWAY_ENDPOINT?: string | undefined;
124
- SETTLEMINT_CUSTOM_DEPLOYMENT?: string | undefined;
125
- SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT?: string | undefined;
126
- SETTLEMINT_BLOCKSCOUT?: string | undefined;
127
- SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT?: string | undefined;
128
- SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT?: string | undefined;
129
- SETTLEMINT_NEW_PROJECT_NAME?: string | undefined;
130
- }, {
131
- SETTLEMINT_INSTANCE?: string | undefined;
132
- SETTLEMINT_ACCESS_TOKEN?: string | undefined;
133
- SETTLEMINT_PERSONAL_ACCESS_TOKEN?: string | undefined;
134
- SETTLEMINT_WORKSPACE?: string | undefined;
135
- SETTLEMINT_APPLICATION?: string | undefined;
136
- SETTLEMINT_BLOCKCHAIN_NETWORK?: string | undefined;
137
- SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID?: string | undefined;
138
- SETTLEMINT_BLOCKCHAIN_NODE?: string | undefined;
139
- SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT?: string | undefined;
140
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER?: string | undefined;
141
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT?: string | undefined;
142
- SETTLEMINT_HASURA?: string | undefined;
143
- SETTLEMINT_HASURA_ENDPOINT?: string | undefined;
144
- SETTLEMINT_HASURA_ADMIN_SECRET?: string | undefined;
145
- SETTLEMINT_HASURA_DATABASE_URL?: string | undefined;
146
- SETTLEMINT_THEGRAPH?: string | undefined;
147
- SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS?: unknown;
148
- SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH?: string | undefined;
149
- SETTLEMINT_PORTAL?: string | undefined;
150
- SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT?: string | undefined;
151
- SETTLEMINT_PORTAL_REST_ENDPOINT?: string | undefined;
152
- SETTLEMINT_PORTAL_WS_ENDPOINT?: string | undefined;
153
- SETTLEMINT_HD_PRIVATE_KEY?: string | undefined;
154
- SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS?: string | undefined;
155
- SETTLEMINT_ACCESSIBLE_PRIVATE_KEY?: string | undefined;
156
- SETTLEMINT_MINIO?: string | undefined;
157
- SETTLEMINT_MINIO_ENDPOINT?: string | undefined;
158
- SETTLEMINT_MINIO_ACCESS_KEY?: string | undefined;
159
- SETTLEMINT_MINIO_SECRET_KEY?: string | undefined;
160
- SETTLEMINT_IPFS?: string | undefined;
161
- SETTLEMINT_IPFS_API_ENDPOINT?: string | undefined;
162
- SETTLEMINT_IPFS_PINNING_ENDPOINT?: string | undefined;
163
- SETTLEMINT_IPFS_GATEWAY_ENDPOINT?: string | undefined;
164
- SETTLEMINT_CUSTOM_DEPLOYMENT?: string | undefined;
165
- SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT?: string | undefined;
166
- SETTLEMINT_BLOCKSCOUT?: string | undefined;
167
- SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT?: string | undefined;
168
- SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT?: string | undefined;
169
- SETTLEMINT_NEW_PROJECT_NAME?: string | undefined;
170
- SETTLEMINT_LOG_LEVEL?: "error" | "info" | "warn" | "debug" | "none" | undefined;
171
- }>;
65
+ SETTLEMINT_INSTANCE: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"standalone">]>>;
66
+ SETTLEMINT_ACCESS_TOKEN: z.ZodOptional<z.ZodString>;
67
+ SETTLEMINT_PERSONAL_ACCESS_TOKEN: z.ZodOptional<z.ZodString>;
68
+ SETTLEMINT_WORKSPACE: z.ZodOptional<z.ZodString>;
69
+ SETTLEMINT_APPLICATION: z.ZodOptional<z.ZodString>;
70
+ SETTLEMINT_BLOCKCHAIN_NETWORK: z.ZodOptional<z.ZodString>;
71
+ SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID: z.ZodOptional<z.ZodString>;
72
+ SETTLEMINT_BLOCKCHAIN_NODE: z.ZodOptional<z.ZodString>;
73
+ SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT: z.ZodOptional<z.ZodString>;
74
+ SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER: z.ZodOptional<z.ZodString>;
75
+ SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT: z.ZodOptional<z.ZodString>;
76
+ SETTLEMINT_HASURA: z.ZodOptional<z.ZodString>;
77
+ SETTLEMINT_HASURA_ENDPOINT: z.ZodOptional<z.ZodString>;
78
+ SETTLEMINT_HASURA_ADMIN_SECRET: z.ZodOptional<z.ZodString>;
79
+ SETTLEMINT_HASURA_DATABASE_URL: z.ZodOptional<z.ZodString>;
80
+ SETTLEMINT_THEGRAPH: z.ZodOptional<z.ZodString>;
81
+ SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS: z.ZodPipe<z.ZodTransform<never[] | null, unknown>, z.ZodOptional<z.ZodArray<z.ZodString>>>;
82
+ SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH: z.ZodOptional<z.ZodString>;
83
+ SETTLEMINT_PORTAL: z.ZodOptional<z.ZodString>;
84
+ SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT: z.ZodOptional<z.ZodString>;
85
+ SETTLEMINT_PORTAL_REST_ENDPOINT: z.ZodOptional<z.ZodString>;
86
+ SETTLEMINT_PORTAL_WS_ENDPOINT: z.ZodOptional<z.ZodString>;
87
+ SETTLEMINT_HD_PRIVATE_KEY: z.ZodOptional<z.ZodString>;
88
+ SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS: z.ZodOptional<z.ZodString>;
89
+ SETTLEMINT_ACCESSIBLE_PRIVATE_KEY: z.ZodOptional<z.ZodString>;
90
+ SETTLEMINT_MINIO: z.ZodOptional<z.ZodString>;
91
+ SETTLEMINT_MINIO_ENDPOINT: z.ZodOptional<z.ZodString>;
92
+ SETTLEMINT_MINIO_ACCESS_KEY: z.ZodOptional<z.ZodString>;
93
+ SETTLEMINT_MINIO_SECRET_KEY: z.ZodOptional<z.ZodString>;
94
+ SETTLEMINT_IPFS: z.ZodOptional<z.ZodString>;
95
+ SETTLEMINT_IPFS_API_ENDPOINT: z.ZodOptional<z.ZodString>;
96
+ SETTLEMINT_IPFS_PINNING_ENDPOINT: z.ZodOptional<z.ZodString>;
97
+ SETTLEMINT_IPFS_GATEWAY_ENDPOINT: z.ZodOptional<z.ZodString>;
98
+ SETTLEMINT_CUSTOM_DEPLOYMENT: z.ZodOptional<z.ZodString>;
99
+ SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT: z.ZodOptional<z.ZodString>;
100
+ SETTLEMINT_BLOCKSCOUT: z.ZodOptional<z.ZodString>;
101
+ SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT: z.ZodOptional<z.ZodString>;
102
+ SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT: z.ZodOptional<z.ZodString>;
103
+ SETTLEMINT_NEW_PROJECT_NAME: z.ZodOptional<z.ZodString>;
104
+ SETTLEMINT_LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
105
+ error: "error";
106
+ debug: "debug";
107
+ info: "info";
108
+ warn: "warn";
109
+ none: "none";
110
+ }>>;
111
+ }, z.core.$strip>;
172
112
  /**
173
113
  * Type definition for the environment variables schema.
174
114
  */
@@ -178,134 +118,158 @@ type DotEnv = z.infer<typeof DotEnvSchema>;
178
118
  * Useful for validating incomplete configurations during development or build time.
179
119
  */
180
120
  declare const DotEnvSchemaPartial: z.ZodObject<{
181
- SETTLEMINT_INSTANCE: z.ZodOptional<z.ZodDefault<z.ZodString>>;
182
- SETTLEMINT_ACCESS_TOKEN: z.ZodOptional<z.ZodOptional<z.ZodString>>;
183
- SETTLEMINT_PERSONAL_ACCESS_TOKEN: z.ZodOptional<z.ZodOptional<z.ZodString>>;
184
- SETTLEMINT_WORKSPACE: z.ZodOptional<z.ZodOptional<z.ZodString>>;
185
- SETTLEMINT_APPLICATION: z.ZodOptional<z.ZodOptional<z.ZodString>>;
186
- SETTLEMINT_BLOCKCHAIN_NETWORK: z.ZodOptional<z.ZodOptional<z.ZodString>>;
187
- SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID: z.ZodOptional<z.ZodOptional<z.ZodString>>;
188
- SETTLEMINT_BLOCKCHAIN_NODE: z.ZodOptional<z.ZodOptional<z.ZodString>>;
189
- SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
190
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER: z.ZodOptional<z.ZodOptional<z.ZodString>>;
191
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
192
- SETTLEMINT_HASURA: z.ZodOptional<z.ZodOptional<z.ZodString>>;
193
- SETTLEMINT_HASURA_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
194
- SETTLEMINT_HASURA_ADMIN_SECRET: z.ZodOptional<z.ZodOptional<z.ZodString>>;
195
- SETTLEMINT_HASURA_DATABASE_URL: z.ZodOptional<z.ZodOptional<z.ZodString>>;
196
- SETTLEMINT_THEGRAPH: z.ZodOptional<z.ZodOptional<z.ZodString>>;
197
- SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS: z.ZodOptional<z.ZodEffects<z.ZodOptional<z.ZodArray<z.ZodString, "many">>, string[] | undefined, unknown>>;
198
- SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH: z.ZodOptional<z.ZodOptional<z.ZodString>>;
199
- SETTLEMINT_PORTAL: z.ZodOptional<z.ZodOptional<z.ZodString>>;
200
- SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
201
- SETTLEMINT_PORTAL_REST_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
202
- SETTLEMINT_PORTAL_WS_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
203
- SETTLEMINT_HD_PRIVATE_KEY: z.ZodOptional<z.ZodOptional<z.ZodString>>;
204
- SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS: z.ZodOptional<z.ZodOptional<z.ZodString>>;
205
- SETTLEMINT_ACCESSIBLE_PRIVATE_KEY: z.ZodOptional<z.ZodOptional<z.ZodString>>;
206
- SETTLEMINT_MINIO: z.ZodOptional<z.ZodOptional<z.ZodString>>;
207
- SETTLEMINT_MINIO_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
208
- SETTLEMINT_MINIO_ACCESS_KEY: z.ZodOptional<z.ZodOptional<z.ZodString>>;
209
- SETTLEMINT_MINIO_SECRET_KEY: z.ZodOptional<z.ZodOptional<z.ZodString>>;
210
- SETTLEMINT_IPFS: z.ZodOptional<z.ZodOptional<z.ZodString>>;
211
- SETTLEMINT_IPFS_API_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
212
- SETTLEMINT_IPFS_PINNING_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
213
- SETTLEMINT_IPFS_GATEWAY_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
214
- SETTLEMINT_CUSTOM_DEPLOYMENT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
215
- SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
216
- SETTLEMINT_BLOCKSCOUT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
217
- SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
218
- SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
219
- SETTLEMINT_NEW_PROJECT_NAME: z.ZodOptional<z.ZodOptional<z.ZodString>>;
220
- SETTLEMINT_LOG_LEVEL: z.ZodOptional<z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error", "none"]>>>;
221
- }, "strip", z.ZodTypeAny, {
222
- SETTLEMINT_INSTANCE?: string | undefined;
223
- SETTLEMINT_ACCESS_TOKEN?: string | undefined;
224
- SETTLEMINT_PERSONAL_ACCESS_TOKEN?: string | undefined;
225
- SETTLEMINT_WORKSPACE?: string | undefined;
226
- SETTLEMINT_APPLICATION?: string | undefined;
227
- SETTLEMINT_BLOCKCHAIN_NETWORK?: string | undefined;
228
- SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID?: string | undefined;
229
- SETTLEMINT_BLOCKCHAIN_NODE?: string | undefined;
230
- SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT?: string | undefined;
231
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER?: string | undefined;
232
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT?: string | undefined;
233
- SETTLEMINT_HASURA?: string | undefined;
234
- SETTLEMINT_HASURA_ENDPOINT?: string | undefined;
235
- SETTLEMINT_HASURA_ADMIN_SECRET?: string | undefined;
236
- SETTLEMINT_HASURA_DATABASE_URL?: string | undefined;
237
- SETTLEMINT_THEGRAPH?: string | undefined;
238
- SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS?: string[] | undefined;
239
- SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH?: string | undefined;
240
- SETTLEMINT_PORTAL?: string | undefined;
241
- SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT?: string | undefined;
242
- SETTLEMINT_PORTAL_REST_ENDPOINT?: string | undefined;
243
- SETTLEMINT_PORTAL_WS_ENDPOINT?: string | undefined;
244
- SETTLEMINT_HD_PRIVATE_KEY?: string | undefined;
245
- SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS?: string | undefined;
246
- SETTLEMINT_ACCESSIBLE_PRIVATE_KEY?: string | undefined;
247
- SETTLEMINT_MINIO?: string | undefined;
248
- SETTLEMINT_MINIO_ENDPOINT?: string | undefined;
249
- SETTLEMINT_MINIO_ACCESS_KEY?: string | undefined;
250
- SETTLEMINT_MINIO_SECRET_KEY?: string | undefined;
251
- SETTLEMINT_IPFS?: string | undefined;
252
- SETTLEMINT_IPFS_API_ENDPOINT?: string | undefined;
253
- SETTLEMINT_IPFS_PINNING_ENDPOINT?: string | undefined;
254
- SETTLEMINT_IPFS_GATEWAY_ENDPOINT?: string | undefined;
255
- SETTLEMINT_CUSTOM_DEPLOYMENT?: string | undefined;
256
- SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT?: string | undefined;
257
- SETTLEMINT_BLOCKSCOUT?: string | undefined;
258
- SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT?: string | undefined;
259
- SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT?: string | undefined;
260
- SETTLEMINT_NEW_PROJECT_NAME?: string | undefined;
261
- SETTLEMINT_LOG_LEVEL?: "error" | "info" | "warn" | "debug" | "none" | undefined;
262
- }, {
263
- SETTLEMINT_INSTANCE?: string | undefined;
264
- SETTLEMINT_ACCESS_TOKEN?: string | undefined;
265
- SETTLEMINT_PERSONAL_ACCESS_TOKEN?: string | undefined;
266
- SETTLEMINT_WORKSPACE?: string | undefined;
267
- SETTLEMINT_APPLICATION?: string | undefined;
268
- SETTLEMINT_BLOCKCHAIN_NETWORK?: string | undefined;
269
- SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID?: string | undefined;
270
- SETTLEMINT_BLOCKCHAIN_NODE?: string | undefined;
271
- SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT?: string | undefined;
272
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER?: string | undefined;
273
- SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT?: string | undefined;
274
- SETTLEMINT_HASURA?: string | undefined;
275
- SETTLEMINT_HASURA_ENDPOINT?: string | undefined;
276
- SETTLEMINT_HASURA_ADMIN_SECRET?: string | undefined;
277
- SETTLEMINT_HASURA_DATABASE_URL?: string | undefined;
278
- SETTLEMINT_THEGRAPH?: string | undefined;
279
- SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS?: unknown;
280
- SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH?: string | undefined;
281
- SETTLEMINT_PORTAL?: string | undefined;
282
- SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT?: string | undefined;
283
- SETTLEMINT_PORTAL_REST_ENDPOINT?: string | undefined;
284
- SETTLEMINT_PORTAL_WS_ENDPOINT?: string | undefined;
285
- SETTLEMINT_HD_PRIVATE_KEY?: string | undefined;
286
- SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS?: string | undefined;
287
- SETTLEMINT_ACCESSIBLE_PRIVATE_KEY?: string | undefined;
288
- SETTLEMINT_MINIO?: string | undefined;
289
- SETTLEMINT_MINIO_ENDPOINT?: string | undefined;
290
- SETTLEMINT_MINIO_ACCESS_KEY?: string | undefined;
291
- SETTLEMINT_MINIO_SECRET_KEY?: string | undefined;
292
- SETTLEMINT_IPFS?: string | undefined;
293
- SETTLEMINT_IPFS_API_ENDPOINT?: string | undefined;
294
- SETTLEMINT_IPFS_PINNING_ENDPOINT?: string | undefined;
295
- SETTLEMINT_IPFS_GATEWAY_ENDPOINT?: string | undefined;
296
- SETTLEMINT_CUSTOM_DEPLOYMENT?: string | undefined;
297
- SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT?: string | undefined;
298
- SETTLEMINT_BLOCKSCOUT?: string | undefined;
299
- SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT?: string | undefined;
300
- SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT?: string | undefined;
301
- SETTLEMINT_NEW_PROJECT_NAME?: string | undefined;
302
- SETTLEMINT_LOG_LEVEL?: "error" | "info" | "warn" | "debug" | "none" | undefined;
303
- }>;
121
+ SETTLEMINT_INSTANCE: z.ZodOptional<z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"standalone">]>>>;
122
+ SETTLEMINT_ACCESS_TOKEN: z.ZodOptional<z.ZodOptional<z.ZodString>>;
123
+ SETTLEMINT_PERSONAL_ACCESS_TOKEN: z.ZodOptional<z.ZodOptional<z.ZodString>>;
124
+ SETTLEMINT_WORKSPACE: z.ZodOptional<z.ZodOptional<z.ZodString>>;
125
+ SETTLEMINT_APPLICATION: z.ZodOptional<z.ZodOptional<z.ZodString>>;
126
+ SETTLEMINT_BLOCKCHAIN_NETWORK: z.ZodOptional<z.ZodOptional<z.ZodString>>;
127
+ SETTLEMINT_BLOCKCHAIN_NETWORK_CHAIN_ID: z.ZodOptional<z.ZodOptional<z.ZodString>>;
128
+ SETTLEMINT_BLOCKCHAIN_NODE: z.ZodOptional<z.ZodOptional<z.ZodString>>;
129
+ SETTLEMINT_BLOCKCHAIN_NODE_JSON_RPC_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
130
+ SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER: z.ZodOptional<z.ZodOptional<z.ZodString>>;
131
+ SETTLEMINT_BLOCKCHAIN_NODE_OR_LOAD_BALANCER_JSON_RPC_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
132
+ SETTLEMINT_HASURA: z.ZodOptional<z.ZodOptional<z.ZodString>>;
133
+ SETTLEMINT_HASURA_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
134
+ SETTLEMINT_HASURA_ADMIN_SECRET: z.ZodOptional<z.ZodOptional<z.ZodString>>;
135
+ SETTLEMINT_HASURA_DATABASE_URL: z.ZodOptional<z.ZodOptional<z.ZodString>>;
136
+ SETTLEMINT_THEGRAPH: z.ZodOptional<z.ZodOptional<z.ZodString>>;
137
+ SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS: z.ZodOptional<z.ZodPipe<z.ZodTransform<never[] | null, unknown>, z.ZodOptional<z.ZodArray<z.ZodString>>>>;
138
+ SETTLEMINT_THEGRAPH_DEFAULT_SUBGRAPH: z.ZodOptional<z.ZodOptional<z.ZodString>>;
139
+ SETTLEMINT_PORTAL: z.ZodOptional<z.ZodOptional<z.ZodString>>;
140
+ SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
141
+ SETTLEMINT_PORTAL_REST_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
142
+ SETTLEMINT_PORTAL_WS_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
143
+ SETTLEMINT_HD_PRIVATE_KEY: z.ZodOptional<z.ZodOptional<z.ZodString>>;
144
+ SETTLEMINT_HD_PRIVATE_KEY_FORWARDER_ADDRESS: z.ZodOptional<z.ZodOptional<z.ZodString>>;
145
+ SETTLEMINT_ACCESSIBLE_PRIVATE_KEY: z.ZodOptional<z.ZodOptional<z.ZodString>>;
146
+ SETTLEMINT_MINIO: z.ZodOptional<z.ZodOptional<z.ZodString>>;
147
+ SETTLEMINT_MINIO_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
148
+ SETTLEMINT_MINIO_ACCESS_KEY: z.ZodOptional<z.ZodOptional<z.ZodString>>;
149
+ SETTLEMINT_MINIO_SECRET_KEY: z.ZodOptional<z.ZodOptional<z.ZodString>>;
150
+ SETTLEMINT_IPFS: z.ZodOptional<z.ZodOptional<z.ZodString>>;
151
+ SETTLEMINT_IPFS_API_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
152
+ SETTLEMINT_IPFS_PINNING_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
153
+ SETTLEMINT_IPFS_GATEWAY_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
154
+ SETTLEMINT_CUSTOM_DEPLOYMENT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
155
+ SETTLEMINT_CUSTOM_DEPLOYMENT_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
156
+ SETTLEMINT_BLOCKSCOUT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
157
+ SETTLEMINT_BLOCKSCOUT_GRAPHQL_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
158
+ SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT: z.ZodOptional<z.ZodOptional<z.ZodString>>;
159
+ SETTLEMINT_NEW_PROJECT_NAME: z.ZodOptional<z.ZodOptional<z.ZodString>>;
160
+ SETTLEMINT_LOG_LEVEL: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
161
+ error: "error";
162
+ debug: "debug";
163
+ info: "info";
164
+ warn: "warn";
165
+ none: "none";
166
+ }>>>;
167
+ }, z.core.$strip>;
304
168
  /**
305
169
  * Type definition for the partial environment variables schema.
306
170
  */
307
171
  type DotEnvPartial = z.infer<typeof DotEnvSchemaPartial>;
308
172
 
173
+ //#endregion
174
+ //#region src/validation/id.schema.d.ts
175
+ /**
176
+ * Schema for validating database IDs. Accepts both PostgreSQL UUIDs and MongoDB ObjectIDs.
177
+ * PostgreSQL UUIDs are 32 hexadecimal characters with hyphens (e.g. 123e4567-e89b-12d3-a456-426614174000).
178
+ * MongoDB ObjectIDs are 24 hexadecimal characters (e.g. 507f1f77bcf86cd799439011).
179
+ *
180
+ * @example
181
+ * import { IdSchema } from "@settlemint/sdk-utils/validation";
182
+ *
183
+ * // Validate PostgreSQL UUID
184
+ * const isValidUuid = IdSchema.safeParse("123e4567-e89b-12d3-a456-426614174000").success;
185
+ *
186
+ * // Validate MongoDB ObjectID
187
+ * const isValidObjectId = IdSchema.safeParse("507f1f77bcf86cd799439011").success;
188
+ */
189
+ declare const IdSchema: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
190
+ /**
191
+ * Type definition for database IDs, inferred from IdSchema.
192
+ * Can be either a PostgreSQL UUID string or MongoDB ObjectID string.
193
+ */
194
+ type Id = z.infer<typeof IdSchema>;
195
+
196
+ //#endregion
197
+ //#region src/validation/unique-name.schema.d.ts
198
+ /**
199
+ * Schema for validating unique names used across the SettleMint platform.
200
+ * Only accepts lowercase alphanumeric characters and hyphens.
201
+ * Used for workspace names, application names, service names etc.
202
+ *
203
+ * @example
204
+ * import { UniqueNameSchema } from "@settlemint/sdk-utils/validation";
205
+ *
206
+ * // Validate a workspace name
207
+ * const isValidName = UniqueNameSchema.safeParse("my-workspace-123").success;
208
+ * // true
209
+ *
210
+ * // Invalid names will fail validation
211
+ * const isInvalidName = UniqueNameSchema.safeParse("My Workspace!").success;
212
+ * // false
213
+ */
214
+ declare const UniqueNameSchema: z.ZodString;
215
+ /**
216
+ * Type definition for unique names, inferred from UniqueNameSchema.
217
+ */
218
+ type UniqueName = z.infer<typeof UniqueNameSchema>;
219
+
220
+ //#endregion
221
+ //#region src/validation/url.schema.d.ts
222
+ /**
223
+ * Schema for validating URLs.
224
+ *
225
+ * @example
226
+ * import { UrlSchema } from "@settlemint/sdk-utils/validation";
227
+ *
228
+ * // Validate a URL
229
+ * const isValidUrl = UrlSchema.safeParse("https://console.settlemint.com").success;
230
+ * // true
231
+ *
232
+ * // Invalid URLs will fail validation
233
+ * const isInvalidUrl = UrlSchema.safeParse("not-a-url").success;
234
+ * // false
235
+ */
236
+ declare const UrlSchema: z.ZodString;
237
+ type Url = z.infer<typeof UrlSchema>;
238
+ /**
239
+ * Schema for validating URL paths.
240
+ *
241
+ * @example
242
+ * import { UrlPathSchema } from "@settlemint/sdk-utils/validation";
243
+ *
244
+ * // Validate a URL path
245
+ * const isValidPath = UrlPathSchema.safeParse("/api/v1/users").success;
246
+ * // true
247
+ *
248
+ * // Invalid paths will fail validation
249
+ * const isInvalidPath = UrlPathSchema.safeParse("not-a-path").success;
250
+ * // false
251
+ */
252
+ declare const UrlPathSchema: z.ZodString;
253
+ type UrlPath = z.infer<typeof UrlPathSchema>;
254
+ /**
255
+ * Schema that accepts either a full URL or a URL path.
256
+ *
257
+ * @example
258
+ * import { UrlOrPathSchema } from "@settlemint/sdk-utils/validation";
259
+ *
260
+ * // Validate a URL
261
+ * const isValidUrl = UrlOrPathSchema.safeParse("https://console.settlemint.com").success;
262
+ * // true
263
+ *
264
+ * // Validate a path
265
+ * const isValidPath = UrlOrPathSchema.safeParse("/api/v1/users").success;
266
+ * // true
267
+ */
268
+ declare const UrlOrPathSchema: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
269
+ type UrlOrPath = z.infer<typeof UrlOrPathSchema>;
270
+
271
+ //#endregion
272
+ //#region src/environment/load-env.d.ts
309
273
  /**
310
274
  * Loads environment variables from .env files.
311
275
  * To enable encryption with dotenvx (https://www.dotenvx.com/docs) run `bunx dotenvx encrypt`
@@ -327,6 +291,8 @@ type DotEnvPartial = z.infer<typeof DotEnvSchemaPartial>;
327
291
  */
328
292
  declare function loadEnv<T extends boolean = true>(validateEnv: T, prod: boolean, path?: string): Promise<T extends true ? DotEnv : DotEnvPartial>;
329
293
 
294
+ //#endregion
295
+ //#region src/environment/write-env.d.ts
330
296
  /**
331
297
  * Writes environment variables to .env files across a project or monorepo
332
298
  *
@@ -358,11 +324,18 @@ declare function loadEnv<T extends boolean = true>(validateEnv: T, prod: boolean
358
324
  * secrets: true
359
325
  * });
360
326
  */
361
- declare function writeEnv({ prod, env, secrets, cwd, }: {
362
- prod: boolean;
363
- env: Partial<DotEnv>;
364
- secrets: boolean;
365
- cwd?: string;
327
+ declare function writeEnv({
328
+ prod,
329
+ env,
330
+ secrets,
331
+ cwd
332
+ }: {
333
+ prod: boolean;
334
+ env: Partial<DotEnv>;
335
+ secrets: boolean;
336
+ cwd?: string;
366
337
  }): Promise<void>;
367
338
 
339
+ //#endregion
368
340
  export { loadEnv, writeEnv };
341
+ //# sourceMappingURL=environment.d.cts.map