@3lineas/groovepack 0.1.3 → 1.1.0

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 (34) hide show
  1. package/README.md +264 -105
  2. package/dist/action-response.type-XlzII9Lr.d.ts +11 -0
  3. package/dist/api-action/index.d.ts +44 -0
  4. package/dist/api-action/index.js +105 -0
  5. package/dist/api-action/index.js.map +1 -0
  6. package/dist/api-client/index.d.ts +46 -0
  7. package/dist/api-client/index.js +142 -0
  8. package/dist/api-client/index.js.map +1 -0
  9. package/dist/api-toast/index.d.ts +58 -0
  10. package/dist/api-toast/index.js +52 -0
  11. package/dist/api-toast/index.js.map +1 -0
  12. package/dist/batch-capable-db.type-Cyybxkjc.d.ts +8 -0
  13. package/dist/chunk-PDWE3D4J.js +130 -0
  14. package/dist/chunk-PDWE3D4J.js.map +1 -0
  15. package/dist/groovepack-locale.type-CaXo9vLj.d.ts +3 -0
  16. package/dist/i18n/index.d.ts +83 -0
  17. package/dist/i18n/index.js +17 -0
  18. package/dist/i18n/index.js.map +1 -0
  19. package/dist/logger/index.d.ts +19 -0
  20. package/dist/logger/index.js +92 -0
  21. package/dist/logger/index.js.map +1 -0
  22. package/dist/pipeline/pipeline.d.ts +41 -0
  23. package/dist/pipeline/pipeline.js +64 -0
  24. package/dist/pipeline/pipeline.js.map +1 -0
  25. package/dist/pipeline/with-d1-transaction.d.ts +16 -0
  26. package/dist/pipeline/with-d1-transaction.js +17 -0
  27. package/dist/pipeline/with-d1-transaction.js.map +1 -0
  28. package/package.json +55 -16
  29. package/dist/index.js +0 -426
  30. package/dist/index.js.map +0 -1
  31. package/registry/common/api-client/files/index.ts.template +0 -296
  32. package/registry/common/logger/files/index.ts.template +0 -194
  33. package/registry/react/api-action/files/index.ts.template +0 -291
  34. package/registry/react/api-toast/files/index.ts.template +0 -169
@@ -0,0 +1,46 @@
1
+ import * as hono_utils_types from 'hono/utils/types';
2
+ import * as node_modules_hono_dist_types_client_types from 'node_modules/hono/dist/types/client/types';
3
+ import { Hono, Env, Schema } from 'hono';
4
+
5
+ /**
6
+ * Configuration options for `createApiClient`.
7
+ */
8
+ interface ApiClientConfig {
9
+ /** Base API URL (e.g. `https://api.example.com`). */
10
+ baseUrl?: string;
11
+ /** Storage key used when reading/writing JWTs from `localStorage`. Defaults to `"token"`. */
12
+ tokenStorageKey?: string;
13
+ /** Optional async or sync token provider (e.g. from cookies or session). */
14
+ getToken?: () => string | null | Promise<string | null>;
15
+ /** Additional static headers merged into every request. */
16
+ defaultHeaders?: Record<string, string>;
17
+ /** Custom `fetch` implementation (useful in SSR, Cloudflare Workers, or tests). */
18
+ fetcher?: typeof fetch;
19
+ }
20
+
21
+ /**
22
+ * Standardized REST API client returned by `createApiClient`.
23
+ */
24
+ interface RestApiClient {
25
+ get: (path: string, init?: RequestInit) => Promise<Response>;
26
+ post: (path: string, body?: unknown, init?: RequestInit) => Promise<Response>;
27
+ put: (path: string, body?: unknown, init?: RequestInit) => Promise<Response>;
28
+ patch: (path: string, body?: unknown, init?: RequestInit) => Promise<Response>;
29
+ delete: (path: string, init?: RequestInit) => Promise<Response>;
30
+ setToken: (token: string) => void;
31
+ removeToken: () => void;
32
+ }
33
+
34
+ /**
35
+ * Creates a standardized REST API client with automatic Bearer token injection,
36
+ * `BigInt`-safe JSON serialization, and `FormData` support.
37
+ */
38
+ declare function createApiClient(config?: ApiClientConfig): RestApiClient;
39
+
40
+ /**
41
+ * Creates a typed Hono RPC client (`hc<TApp>()`) with automatic Bearer token injection.
42
+ * Requires `hono` to be installed in the consumer project.
43
+ */
44
+ declare function createHonoClient<TApp extends Hono<Env, Schema, string>>(config?: ApiClientConfig): hono_utils_types.UnionToIntersection<node_modules_hono_dist_types_client_types.Client<TApp, string>>;
45
+
46
+ export { type ApiClientConfig, type RestApiClient, createApiClient, createHonoClient };
@@ -0,0 +1,142 @@
1
+ // src/api-client/get-stored-token.ts
2
+ function getStoredToken(storageKey) {
3
+ try {
4
+ if (typeof globalThis !== "undefined" && "localStorage" in globalThis && globalThis.localStorage) {
5
+ return globalThis.localStorage.getItem(storageKey);
6
+ }
7
+ } catch {
8
+ return null;
9
+ }
10
+ return null;
11
+ }
12
+
13
+ // src/api-client/resolve-headers.ts
14
+ async function resolveHeaders(defaultHeaders, tokenStorageKey, getToken, extraHeaders, isFormData = false) {
15
+ const headers = new Headers(defaultHeaders);
16
+ if (!isFormData && !headers.has("Content-Type")) {
17
+ headers.set("Content-Type", "application/json");
18
+ }
19
+ if (extraHeaders) {
20
+ new Headers(extraHeaders).forEach((headerValue, headerKey) => {
21
+ headers.set(headerKey, headerValue);
22
+ });
23
+ }
24
+ const token = getToken ? await getToken() : getStoredToken(tokenStorageKey);
25
+ if (token && !headers.has("Authorization")) {
26
+ headers.set("Authorization", `Bearer ${token}`);
27
+ }
28
+ return headers;
29
+ }
30
+
31
+ // src/api-client/resolve-url.ts
32
+ function resolveUrl(baseUrl, path) {
33
+ if (path.startsWith("http://") || path.startsWith("https://")) {
34
+ return path;
35
+ }
36
+ const normalizedBase = baseUrl.replace(/\/+$/, "");
37
+ const normalizedPath = path.startsWith("/") ? path : `/${path}`;
38
+ return `${normalizedBase}${normalizedPath}`;
39
+ }
40
+
41
+ // src/api-client/serialize-body.ts
42
+ function serializeBody(body) {
43
+ if (body === void 0) {
44
+ return void 0;
45
+ }
46
+ if (typeof body === "string" || body instanceof FormData || body instanceof URLSearchParams || body instanceof Blob) {
47
+ return body;
48
+ }
49
+ return JSON.stringify(
50
+ body,
51
+ (_key, fieldValue) => typeof fieldValue === "bigint" ? fieldValue.toString() : fieldValue
52
+ );
53
+ }
54
+
55
+ // src/api-client/set-stored-token.ts
56
+ function setStoredToken(storageKey, token) {
57
+ try {
58
+ if (typeof globalThis !== "undefined" && "localStorage" in globalThis && globalThis.localStorage) {
59
+ globalThis.localStorage.setItem(storageKey, token);
60
+ }
61
+ } catch {
62
+ }
63
+ }
64
+
65
+ // src/api-client/remove-stored-token.ts
66
+ function removeStoredToken(storageKey) {
67
+ try {
68
+ if (typeof globalThis !== "undefined" && "localStorage" in globalThis && globalThis.localStorage) {
69
+ globalThis.localStorage.removeItem(storageKey);
70
+ }
71
+ } catch {
72
+ }
73
+ }
74
+
75
+ // src/api-client/create-api-client.ts
76
+ function createApiClient(config = {}) {
77
+ const {
78
+ baseUrl = "",
79
+ tokenStorageKey = "token",
80
+ getToken,
81
+ defaultHeaders,
82
+ fetcher = fetch
83
+ } = config;
84
+ async function request(method, path, body, init) {
85
+ const isFormData = typeof FormData !== "undefined" && body instanceof FormData;
86
+ const headers = await resolveHeaders(
87
+ defaultHeaders,
88
+ tokenStorageKey,
89
+ getToken,
90
+ init?.headers,
91
+ isFormData
92
+ );
93
+ return fetcher(resolveUrl(baseUrl, path), {
94
+ ...init,
95
+ method,
96
+ headers,
97
+ body: serializeBody(body)
98
+ });
99
+ }
100
+ return {
101
+ get: (path, init) => request("GET", path, void 0, init),
102
+ post: (path, body, init) => request("POST", path, body, init),
103
+ put: (path, body, init) => request("PUT", path, body, init),
104
+ patch: (path, body, init) => request("PATCH", path, body, init),
105
+ delete: (path, init) => request("DELETE", path, void 0, init),
106
+ setToken: (token) => setStoredToken(tokenStorageKey, token),
107
+ removeToken: () => removeStoredToken(tokenStorageKey)
108
+ };
109
+ }
110
+
111
+ // src/api-client/create-hono-client.ts
112
+ import { hc } from "hono/client";
113
+ function createHonoClient(config = {}) {
114
+ const {
115
+ baseUrl = "",
116
+ tokenStorageKey = "token",
117
+ getToken,
118
+ defaultHeaders,
119
+ fetcher = fetch
120
+ } = config;
121
+ return hc(baseUrl, {
122
+ fetch: async (input, init) => {
123
+ const isFormData = typeof FormData !== "undefined" && init?.body instanceof FormData;
124
+ const headers = await resolveHeaders(
125
+ defaultHeaders,
126
+ tokenStorageKey,
127
+ getToken,
128
+ init?.headers,
129
+ isFormData
130
+ );
131
+ return fetcher(input, {
132
+ ...init,
133
+ headers
134
+ });
135
+ }
136
+ });
137
+ }
138
+ export {
139
+ createApiClient,
140
+ createHonoClient
141
+ };
142
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/api-client/get-stored-token.ts","../../src/api-client/resolve-headers.ts","../../src/api-client/resolve-url.ts","../../src/api-client/serialize-body.ts","../../src/api-client/set-stored-token.ts","../../src/api-client/remove-stored-token.ts","../../src/api-client/create-api-client.ts","../../src/api-client/create-hono-client.ts"],"sourcesContent":["/**\n * Safely reads a stored token from `globalThis.localStorage` when running in a browser.\n */\nexport function getStoredToken(storageKey: string): string | null {\n try {\n if (\n typeof globalThis !== \"undefined\" &&\n \"localStorage\" in globalThis &&\n globalThis.localStorage\n ) {\n return globalThis.localStorage.getItem(storageKey);\n }\n } catch {\n return null;\n }\n return null;\n}\n","import { getStoredToken } from \"@/api-client/get-stored-token\";\n\n/**\n * Resolves request headers by merging `defaultHeaders`, per-request headers,\n * `Content-Type: application/json` (when not FormData), and `Authorization: Bearer`.\n */\nexport async function resolveHeaders(\n defaultHeaders: Record<string, string> | undefined,\n tokenStorageKey: string,\n getToken: (() => string | null | Promise<string | null>) | undefined,\n extraHeaders?: HeadersInit,\n isFormData = false,\n): Promise<Headers> {\n const headers = new Headers(defaultHeaders);\n\n if (!isFormData && !headers.has(\"Content-Type\")) {\n headers.set(\"Content-Type\", \"application/json\");\n }\n\n if (extraHeaders) {\n new Headers(extraHeaders).forEach((headerValue, headerKey) => {\n headers.set(headerKey, headerValue);\n });\n }\n\n const token = getToken ? await getToken() : getStoredToken(tokenStorageKey);\n if (token && !headers.has(\"Authorization\")) {\n headers.set(\"Authorization\", `Bearer ${token}`);\n }\n\n return headers;\n}\n","/**\n * Resolves a relative or absolute path against `baseUrl`.\n */\nexport function resolveUrl(baseUrl: string, path: string): string {\n if (path.startsWith(\"http://\") || path.startsWith(\"https://\")) {\n return path;\n }\n const normalizedBase = baseUrl.replace(/\\/+$/, \"\");\n const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n return `${normalizedBase}${normalizedPath}`;\n}\n","/**\n * Serializes a request body to `BodyInit | undefined`, supporting `FormData`,\n * `URLSearchParams`, `Blob`, `string`, and JSON with `BigInt` safety.\n */\nexport function serializeBody(body: unknown): BodyInit | undefined {\n if (body === undefined) {\n return undefined;\n }\n\n if (\n typeof body === \"string\" ||\n body instanceof FormData ||\n body instanceof URLSearchParams ||\n body instanceof Blob\n ) {\n return body;\n }\n\n return JSON.stringify(body, (_key, fieldValue) =>\n typeof fieldValue === \"bigint\" ? fieldValue.toString() : fieldValue,\n );\n}\n","/**\n * Safely persists a token to `globalThis.localStorage` when running in a browser.\n */\nexport function setStoredToken(storageKey: string, token: string): void {\n try {\n if (\n typeof globalThis !== \"undefined\" &&\n \"localStorage\" in globalThis &&\n globalThis.localStorage\n ) {\n globalThis.localStorage.setItem(storageKey, token);\n }\n } catch {\n // Ignore storage errors in restricted environments\n }\n}\n","/**\n * Safely removes a stored token from `globalThis.localStorage` when running in a browser.\n */\nexport function removeStoredToken(storageKey: string): void {\n try {\n if (\n typeof globalThis !== \"undefined\" &&\n \"localStorage\" in globalThis &&\n globalThis.localStorage\n ) {\n globalThis.localStorage.removeItem(storageKey);\n }\n } catch {\n // Ignore storage errors in restricted environments\n }\n}\n","import type { ApiClientConfig } from \"@/types/api-client/api-client-config.type\";\nimport type { RestApiClient } from \"@/types/api-client/rest-api-client.type\";\nimport { resolveHeaders } from \"@/api-client/resolve-headers\";\nimport { resolveUrl } from \"@/api-client/resolve-url\";\nimport { serializeBody } from \"@/api-client/serialize-body\";\nimport { setStoredToken } from \"@/api-client/set-stored-token\";\nimport { removeStoredToken } from \"@/api-client/remove-stored-token\";\n\n/**\n * Creates a standardized REST API client with automatic Bearer token injection,\n * `BigInt`-safe JSON serialization, and `FormData` support.\n */\nexport function createApiClient(config: ApiClientConfig = {}): RestApiClient {\n const {\n baseUrl = \"\",\n tokenStorageKey = \"token\",\n getToken,\n defaultHeaders,\n fetcher = fetch,\n } = config;\n\n async function request(\n method: string,\n path: string,\n body?: unknown,\n init?: RequestInit,\n ): Promise<Response> {\n const isFormData =\n typeof FormData !== \"undefined\" && body instanceof FormData;\n const headers = await resolveHeaders(\n defaultHeaders,\n tokenStorageKey,\n getToken,\n init?.headers,\n isFormData,\n );\n\n return fetcher(resolveUrl(baseUrl, path), {\n ...init,\n method,\n headers,\n body: serializeBody(body),\n });\n }\n\n return {\n get: (path, init) => request(\"GET\", path, undefined, init),\n post: (path, body, init) => request(\"POST\", path, body, init),\n put: (path, body, init) => request(\"PUT\", path, body, init),\n patch: (path, body, init) => request(\"PATCH\", path, body, init),\n delete: (path, init) => request(\"DELETE\", path, undefined, init),\n setToken: (token) => setStoredToken(tokenStorageKey, token),\n removeToken: () => removeStoredToken(tokenStorageKey),\n };\n}\n","import type { Env, Hono, Schema } from \"hono\";\nimport { hc } from \"hono/client\";\nimport type { ApiClientConfig } from \"@/types/api-client/api-client-config.type\";\nimport { resolveHeaders } from \"@/api-client/resolve-headers\";\n\n/**\n * Creates a typed Hono RPC client (`hc<TApp>()`) with automatic Bearer token injection.\n * Requires `hono` to be installed in the consumer project.\n */\nexport function createHonoClient<\n TApp extends Hono<Env, Schema, string>,\n>(config: ApiClientConfig = {}) {\n const {\n baseUrl = \"\",\n tokenStorageKey = \"token\",\n getToken,\n defaultHeaders,\n fetcher = fetch,\n } = config;\n\n return hc<TApp>(baseUrl, {\n fetch: async (input: RequestInfo | URL, init?: RequestInit) => {\n const isFormData =\n typeof FormData !== \"undefined\" && init?.body instanceof FormData;\n const headers = await resolveHeaders(\n defaultHeaders,\n tokenStorageKey,\n getToken,\n init?.headers,\n isFormData,\n );\n\n return fetcher(input, {\n ...init,\n headers,\n });\n },\n });\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,58 @@
1
+ import { A as ActionResponse } from '../action-response.type-XlzII9Lr.js';
2
+ import { G as GroovepackLocale } from '../groovepack-locale.type-CaXo9vLj.js';
3
+
4
+ /**
5
+ * Options for `apiToast`.
6
+ */
7
+ interface ApiToastOptions<T = unknown> {
8
+ /** Async action returning an `ActionResponse<T>`. */
9
+ action: () => Promise<ActionResponse<T>>;
10
+ /** Optional locale override (`"en" | "es" | "pt" | "it" | "fr"`). */
11
+ locale?: GroovepackLocale;
12
+ /** Message displayed while the action is pending. */
13
+ loadingMessage?: string;
14
+ /** Fallback message displayed when `action` succeeds without a `message` field. */
15
+ successMessage?: string;
16
+ /** Fallback message displayed when `action` fails without an `error`/`message` field. */
17
+ errorMessage?: string;
18
+ /** Callback invoked when the action resolves with `success: true`. */
19
+ onSuccess?: (data: T | undefined, response: ActionResponse<T>) => void;
20
+ /** Callback invoked when the action resolves with `success: false` or throws. */
21
+ onError?: (error: string, response?: ActionResponse<T>) => void;
22
+ }
23
+
24
+ /**
25
+ * Default configuration for `createApiToast`.
26
+ */
27
+ interface ApiToastDefaults {
28
+ /** Optional locale override (`"en" | "es" | "pt" | "it" | "fr"`). */
29
+ locale?: GroovepackLocale;
30
+ /** Default loading message when not specified per call. */
31
+ defaultLoadingMessage?: string;
32
+ /** Default success message when not specified per call. */
33
+ defaultSuccessMessage?: string;
34
+ /** Default error message when not specified per call. */
35
+ defaultErrorMessage?: string;
36
+ }
37
+ type ToastedOptions<T = unknown> = {
38
+ action: () => Promise<ActionResponse<T>>;
39
+ locale?: GroovepackLocale;
40
+ loadingMessage?: string;
41
+ successMessage?: string;
42
+ errorMessage?: string;
43
+ onSuccess?: (data: T | undefined, response: ActionResponse<T>) => void;
44
+ onError?: (error: string, response?: ActionResponse<T>) => void;
45
+ };
46
+
47
+ /**
48
+ * Factory creating a pre-configured `apiToast` helper with custom default
49
+ * messages and/or locale.
50
+ */
51
+ declare function createApiToast(defaults?: ApiToastDefaults): <T = unknown>({ action, locale, loadingMessage, successMessage, errorMessage, onSuccess, onError, }: ApiToastOptions<T>) => Promise<ActionResponse<T>>;
52
+
53
+ /**
54
+ * Wraps an `ActionResponse<T>` promise with `sonner` loading, success, and error toasts.
55
+ */
56
+ declare const apiToast: <T = unknown>({ action, locale, loadingMessage, successMessage, errorMessage, onSuccess, onError, }: ApiToastOptions<T>) => Promise<ActionResponse<T>>;
57
+
58
+ export { ActionResponse, type ApiToastDefaults, type ApiToastOptions, type ToastedOptions, apiToast, createApiToast };
@@ -0,0 +1,52 @@
1
+ import {
2
+ resolveLocaleMessages
3
+ } from "../chunk-PDWE3D4J.js";
4
+
5
+ // src/api-toast/create-api-toast.ts
6
+ import { toast } from "sonner";
7
+ function createApiToast(defaults = {}) {
8
+ return async function configuredApiToast({
9
+ action,
10
+ locale = defaults.locale,
11
+ loadingMessage,
12
+ successMessage,
13
+ errorMessage,
14
+ onSuccess,
15
+ onError
16
+ }) {
17
+ const messages = resolveLocaleMessages(locale);
18
+ const resolvedLoading = loadingMessage ?? defaults.defaultLoadingMessage ?? messages.loading;
19
+ const resolvedSuccess = successMessage ?? defaults.defaultSuccessMessage ?? messages.success;
20
+ const resolvedError = errorMessage ?? defaults.defaultErrorMessage ?? messages.operationFailed;
21
+ const toastId = toast.loading(resolvedLoading);
22
+ try {
23
+ const actionResult = await action();
24
+ if (actionResult.success) {
25
+ const displayMessage = actionResult.message ?? resolvedSuccess;
26
+ toast.success(displayMessage, { id: toastId });
27
+ onSuccess?.(actionResult.data, actionResult);
28
+ return actionResult;
29
+ }
30
+ const displayError = actionResult.error ?? actionResult.message ?? resolvedError;
31
+ toast.error(displayError, { id: toastId });
32
+ onError?.(displayError, actionResult);
33
+ return actionResult;
34
+ } catch (caughtError) {
35
+ const fallbackError = caughtError instanceof Error ? caughtError.message : resolvedError;
36
+ toast.error(fallbackError, { id: toastId });
37
+ onError?.(fallbackError);
38
+ return {
39
+ success: false,
40
+ error: fallbackError
41
+ };
42
+ }
43
+ };
44
+ }
45
+
46
+ // src/api-toast/index.ts
47
+ var apiToast = createApiToast();
48
+ export {
49
+ apiToast,
50
+ createApiToast
51
+ };
52
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/api-toast/create-api-toast.ts","../../src/api-toast/index.ts"],"sourcesContent":["import { toast } from \"sonner\";\nimport type { ActionResponse } from \"@/types/common/action-response.type\";\nimport type { ApiToastDefaults } from \"@/types/api-toast/api-toast-defaults.type\";\nimport type { ApiToastOptions } from \"@/types/api-toast/api-toast-options.type\";\nimport { resolveLocaleMessages } from \"@/i18n/resolve-locale-messages\";\n\n/**\n * Factory creating a pre-configured `apiToast` helper with custom default\n * messages and/or locale.\n */\nexport function createApiToast(defaults: ApiToastDefaults = {}) {\n return async function configuredApiToast<T = unknown>({\n action,\n locale = defaults.locale,\n loadingMessage,\n successMessage,\n errorMessage,\n onSuccess,\n onError,\n }: ApiToastOptions<T>): Promise<ActionResponse<T>> {\n const messages = resolveLocaleMessages(locale);\n const resolvedLoading =\n loadingMessage ?? defaults.defaultLoadingMessage ?? messages.loading;\n const resolvedSuccess =\n successMessage ?? defaults.defaultSuccessMessage ?? messages.success;\n const resolvedError =\n errorMessage ?? defaults.defaultErrorMessage ?? messages.operationFailed;\n\n const toastId = toast.loading(resolvedLoading);\n\n try {\n const actionResult = await action();\n\n if (actionResult.success) {\n const displayMessage = actionResult.message ?? resolvedSuccess;\n toast.success(displayMessage, { id: toastId });\n onSuccess?.(actionResult.data, actionResult);\n return actionResult;\n }\n\n const displayError =\n actionResult.error ?? actionResult.message ?? resolvedError;\n toast.error(displayError, { id: toastId });\n onError?.(displayError, actionResult);\n return actionResult;\n } catch (caughtError) {\n const fallbackError =\n caughtError instanceof Error ? caughtError.message : resolvedError;\n toast.error(fallbackError, { id: toastId });\n onError?.(fallbackError);\n\n return {\n success: false,\n error: fallbackError,\n };\n }\n };\n}\n","import { createApiToast } from \"@/api-toast/create-api-toast\";\n\nexport type { ActionResponse } from \"@/types/common/action-response.type\";\nexport type { ApiToastOptions } from \"@/types/api-toast/api-toast-options.type\";\nexport type {\n ApiToastDefaults,\n ToastedOptions,\n} from \"@/types/api-toast/api-toast-defaults.type\";\nexport { createApiToast } from \"@/api-toast/create-api-toast\";\n\n/**\n * Wraps an `ActionResponse<T>` promise with `sonner` loading, success, and error toasts.\n */\nexport const apiToast = createApiToast();\n"],"mappings":";;;;;AAAA,SAAS,aAAa;AAUf,SAAS,eAAe,WAA6B,CAAC,GAAG;AAC9D,SAAO,eAAe,mBAAgC;AAAA,IACpD;AAAA,IACA,SAAS,SAAS;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAAmD;AACjD,UAAM,WAAW,sBAAsB,MAAM;AAC7C,UAAM,kBACJ,kBAAkB,SAAS,yBAAyB,SAAS;AAC/D,UAAM,kBACJ,kBAAkB,SAAS,yBAAyB,SAAS;AAC/D,UAAM,gBACJ,gBAAgB,SAAS,uBAAuB,SAAS;AAE3D,UAAM,UAAU,MAAM,QAAQ,eAAe;AAE7C,QAAI;AACF,YAAM,eAAe,MAAM,OAAO;AAElC,UAAI,aAAa,SAAS;AACxB,cAAM,iBAAiB,aAAa,WAAW;AAC/C,cAAM,QAAQ,gBAAgB,EAAE,IAAI,QAAQ,CAAC;AAC7C,oBAAY,aAAa,MAAM,YAAY;AAC3C,eAAO;AAAA,MACT;AAEA,YAAM,eACJ,aAAa,SAAS,aAAa,WAAW;AAChD,YAAM,MAAM,cAAc,EAAE,IAAI,QAAQ,CAAC;AACzC,gBAAU,cAAc,YAAY;AACpC,aAAO;AAAA,IACT,SAAS,aAAa;AACpB,YAAM,gBACJ,uBAAuB,QAAQ,YAAY,UAAU;AACvD,YAAM,MAAM,eAAe,EAAE,IAAI,QAAQ,CAAC;AAC1C,gBAAU,aAAa;AAEvB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AACF;;;AC5CO,IAAM,WAAW,eAAe;","names":[]}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Minimal database contract compatible with Cloudflare D1 (`db.batch`) and Drizzle D1.
3
+ */
4
+ interface BatchCapableDb<TStatement = unknown, TResult = unknown> {
5
+ batch: (statements: readonly TStatement[]) => Promise<readonly TResult[]>;
6
+ }
7
+
8
+ export type { BatchCapableDb as B };
@@ -0,0 +1,130 @@
1
+ // src/i18n/is-supported-locale.ts
2
+ var SUPPORTED_LOCALE_SET = /* @__PURE__ */ new Set(["en", "es", "pt", "it", "fr"]);
3
+ function normalizeSupportedLocale(candidate) {
4
+ if (typeof candidate !== "string") {
5
+ return void 0;
6
+ }
7
+ const trimmed = candidate.trim().toLowerCase();
8
+ if (trimmed.length === 0) {
9
+ return void 0;
10
+ }
11
+ const baseTag = trimmed.split(/[-_]/)[0];
12
+ if (!baseTag || !SUPPORTED_LOCALE_SET.has(baseTag)) {
13
+ return void 0;
14
+ }
15
+ return baseTag;
16
+ }
17
+
18
+ // src/i18n/read-env-locale.ts
19
+ var ENV_LOCALE_KEYS = [
20
+ "GROOVEPACK_LOCALE",
21
+ "NEXT_PUBLIC_GROOVEPACK_LOCALE",
22
+ "VITE_GROOVEPACK_LOCALE",
23
+ "PUBLIC_GROOVEPACK_LOCALE"
24
+ ];
25
+ function readLocaleFromRecord(record) {
26
+ if (!record) {
27
+ return void 0;
28
+ }
29
+ for (const key of ENV_LOCALE_KEYS) {
30
+ const normalized = normalizeSupportedLocale(record[key]);
31
+ if (normalized) {
32
+ return normalized;
33
+ }
34
+ }
35
+ return void 0;
36
+ }
37
+ function getProcessEnvRecord() {
38
+ const globalRecord = globalThis;
39
+ const processValue = globalRecord["process"];
40
+ if (typeof processValue !== "object" || processValue === null) {
41
+ return void 0;
42
+ }
43
+ const envValue = processValue["env"];
44
+ if (typeof envValue !== "object" || envValue === null) {
45
+ return void 0;
46
+ }
47
+ return envValue;
48
+ }
49
+ function getImportMetaEnvRecord() {
50
+ const metaValue = import.meta;
51
+ if (typeof metaValue !== "object" || metaValue === null) {
52
+ return void 0;
53
+ }
54
+ const envValue = metaValue["env"];
55
+ if (typeof envValue !== "object" || envValue === null) {
56
+ return void 0;
57
+ }
58
+ return envValue;
59
+ }
60
+ function readEnvLocale() {
61
+ return readLocaleFromRecord(getProcessEnvRecord()) ?? readLocaleFromRecord(getImportMetaEnvRecord());
62
+ }
63
+
64
+ // src/i18n/locale-state.ts
65
+ var configuredLocale;
66
+ function setGroovepackLocale(locale) {
67
+ if (locale === void 0) {
68
+ configuredLocale = void 0;
69
+ return;
70
+ }
71
+ configuredLocale = normalizeSupportedLocale(locale);
72
+ }
73
+ function getGroovepackLocale(overrideLocale) {
74
+ return normalizeSupportedLocale(overrideLocale) ?? configuredLocale ?? readEnvLocale() ?? "en";
75
+ }
76
+
77
+ // src/i18n/messages.ts
78
+ var GROOVEPACK_MESSAGES = {
79
+ en: {
80
+ loading: "Processing...",
81
+ success: "Operation completed successfully.",
82
+ unexpectedError: "An unexpected error occurred while processing your request. Please try again.",
83
+ serverRequestFailed: "Could not process the request on the server. Please try again.",
84
+ operationFailed: "The operation could not be completed."
85
+ },
86
+ es: {
87
+ loading: "Procesando...",
88
+ success: "Operaci\xF3n completada con \xE9xito.",
89
+ unexpectedError: "Ocurri\xF3 un error inesperado al procesar la solicitud. Por favor, intenta de nuevo.",
90
+ serverRequestFailed: "No se pudo procesar la solicitud en el servidor. Por favor, intenta de nuevo.",
91
+ operationFailed: "La operaci\xF3n no se pudo completar."
92
+ },
93
+ pt: {
94
+ loading: "Processando...",
95
+ success: "Opera\xE7\xE3o conclu\xEDda com sucesso.",
96
+ unexpectedError: "Ocorreu um erro inesperado ao processar a solicita\xE7\xE3o. Por favor, tente novamente.",
97
+ serverRequestFailed: "N\xE3o foi poss\xEDvel processar a solicita\xE7\xE3o no servidor. Por favor, tente novamente.",
98
+ operationFailed: "N\xE3o foi poss\xEDvel concluir a opera\xE7\xE3o."
99
+ },
100
+ it: {
101
+ loading: "Elaborazione in corso...",
102
+ success: "Operazione completata con successo.",
103
+ unexpectedError: "Si \xE8 verificato un errore imprevisto durante l'elaborazione della richiesta. Riprova.",
104
+ serverRequestFailed: "Impossibile elaborare la richiesta sul server. Riprova.",
105
+ operationFailed: "Impossibile completare l'operazione."
106
+ },
107
+ fr: {
108
+ loading: "Traitement en cours...",
109
+ success: "Op\xE9ration termin\xE9e avec succ\xE8s.",
110
+ unexpectedError: "Une erreur inattendue s'est produite lors du traitement de la demande. Veuillez r\xE9essayer.",
111
+ serverRequestFailed: "Impossible de traiter la demande sur le serveur. Veuillez r\xE9essayer.",
112
+ operationFailed: "L'op\xE9ration n'a pas pu \xEAtre termin\xE9e."
113
+ }
114
+ };
115
+
116
+ // src/i18n/resolve-locale-messages.ts
117
+ function resolveLocaleMessages(overrideLocale) {
118
+ const activeLocale = getGroovepackLocale(overrideLocale);
119
+ return GROOVEPACK_MESSAGES[activeLocale];
120
+ }
121
+
122
+ export {
123
+ normalizeSupportedLocale,
124
+ readEnvLocale,
125
+ setGroovepackLocale,
126
+ getGroovepackLocale,
127
+ GROOVEPACK_MESSAGES,
128
+ resolveLocaleMessages
129
+ };
130
+ //# sourceMappingURL=chunk-PDWE3D4J.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/i18n/is-supported-locale.ts","../src/i18n/read-env-locale.ts","../src/i18n/locale-state.ts","../src/i18n/messages.ts","../src/i18n/resolve-locale-messages.ts"],"sourcesContent":["import type { GroovepackLocale } from \"@/types/i18n/groovepack-locale.type\";\n\nconst SUPPORTED_LOCALE_SET = new Set<string>([\"en\", \"es\", \"pt\", \"it\", \"fr\"]);\n\n/**\n * Normalizes a candidate locale string (e.g. \"es-AR\" -> \"es\") and returns\n * a supported `GroovepackLocale`, or `undefined` if unsupported.\n */\nexport function normalizeSupportedLocale(\n candidate: unknown,\n): GroovepackLocale | undefined {\n if (typeof candidate !== \"string\") {\n return undefined;\n }\n\n const trimmed = candidate.trim().toLowerCase();\n if (trimmed.length === 0) {\n return undefined;\n }\n\n const baseTag = trimmed.split(/[-_]/)[0];\n if (!baseTag || !SUPPORTED_LOCALE_SET.has(baseTag)) {\n return undefined;\n }\n\n return baseTag as GroovepackLocale;\n}\n","import type { GroovepackLocale } from \"@/types/i18n/groovepack-locale.type\";\nimport { normalizeSupportedLocale } from \"@/i18n/is-supported-locale\";\n\nconst ENV_LOCALE_KEYS = [\n \"GROOVEPACK_LOCALE\",\n \"NEXT_PUBLIC_GROOVEPACK_LOCALE\",\n \"VITE_GROOVEPACK_LOCALE\",\n \"PUBLIC_GROOVEPACK_LOCALE\",\n] as const;\n\nfunction readLocaleFromRecord(\n record: Record<string, unknown> | undefined,\n): GroovepackLocale | undefined {\n if (!record) {\n return undefined;\n }\n\n for (const key of ENV_LOCALE_KEYS) {\n const normalized = normalizeSupportedLocale(record[key]);\n if (normalized) {\n return normalized;\n }\n }\n\n return undefined;\n}\n\nfunction getProcessEnvRecord(): Record<string, unknown> | undefined {\n const globalRecord = globalThis as Record<string, unknown>;\n const processValue = globalRecord[\"process\"];\n if (typeof processValue !== \"object\" || processValue === null) {\n return undefined;\n }\n\n const envValue = (processValue as Record<string, unknown>)[\"env\"];\n if (typeof envValue !== \"object\" || envValue === null) {\n return undefined;\n }\n\n return envValue as Record<string, unknown>;\n}\n\nfunction getImportMetaEnvRecord(): Record<string, unknown> | undefined {\n const metaValue = import.meta as unknown as Record<string, unknown> | undefined;\n if (typeof metaValue !== \"object\" || metaValue === null) {\n return undefined;\n }\n\n const envValue = metaValue[\"env\"];\n if (typeof envValue !== \"object\" || envValue === null) {\n return undefined;\n }\n\n return envValue as Record<string, unknown>;\n}\n\n/**\n * Safely reads `GROOVEPACK_LOCALE` (or framework-prefixed equivalents)\n * across Node.js, Cloudflare Workers, Next.js, Vite, and Astro without\n * requiring `@types/node` or Vite ambient types.\n */\nexport function readEnvLocale(): GroovepackLocale | undefined {\n return (\n readLocaleFromRecord(getProcessEnvRecord()) ??\n readLocaleFromRecord(getImportMetaEnvRecord())\n );\n}\n","import type { GroovepackLocale } from \"@/types/i18n/groovepack-locale.type\";\nimport { normalizeSupportedLocale } from \"@/i18n/is-supported-locale\";\nimport { readEnvLocale } from \"@/i18n/read-env-locale\";\n\nlet configuredLocale: GroovepackLocale | undefined;\n\n/**\n * Sets the global runtime locale for `@3lineas/groovepack` fallback messages.\n * Pass `undefined` to clear the runtime override and fall back to environment\n * variables or `\"en\"`.\n */\nexport function setGroovepackLocale(locale: GroovepackLocale | undefined): void {\n if (locale === undefined) {\n configuredLocale = undefined;\n return;\n }\n\n configuredLocale = normalizeSupportedLocale(locale);\n}\n\n/**\n * Resolves the active locale using precedence:\n * 1. Explicit `overrideLocale`\n * 2. Runtime locale set via `setGroovepackLocale()`\n * 3. Environment variable (`GROOVEPACK_LOCALE` / framework-prefixed)\n * 4. Default `\"en\"`\n */\nexport function getGroovepackLocale(\n overrideLocale?: GroovepackLocale,\n): GroovepackLocale {\n return (\n normalizeSupportedLocale(overrideLocale) ??\n configuredLocale ??\n readEnvLocale() ??\n \"en\"\n );\n}\n","import type { GroovepackLocale } from \"@/types/i18n/groovepack-locale.type\";\nimport type { GroovepackLocaleMessages } from \"@/types/i18n/locale-messages.type\";\n\nexport const GROOVEPACK_MESSAGES = {\n en: {\n loading: \"Processing...\",\n success: \"Operation completed successfully.\",\n unexpectedError:\n \"An unexpected error occurred while processing your request. Please try again.\",\n serverRequestFailed:\n \"Could not process the request on the server. Please try again.\",\n operationFailed: \"The operation could not be completed.\",\n },\n es: {\n loading: \"Procesando...\",\n success: \"Operación completada con éxito.\",\n unexpectedError:\n \"Ocurrió un error inesperado al procesar la solicitud. Por favor, intenta de nuevo.\",\n serverRequestFailed:\n \"No se pudo procesar la solicitud en el servidor. Por favor, intenta de nuevo.\",\n operationFailed: \"La operación no se pudo completar.\",\n },\n pt: {\n loading: \"Processando...\",\n success: \"Operação concluída com sucesso.\",\n unexpectedError:\n \"Ocorreu um erro inesperado ao processar a solicitação. Por favor, tente novamente.\",\n serverRequestFailed:\n \"Não foi possível processar a solicitação no servidor. Por favor, tente novamente.\",\n operationFailed: \"Não foi possível concluir a operação.\",\n },\n it: {\n loading: \"Elaborazione in corso...\",\n success: \"Operazione completata con successo.\",\n unexpectedError:\n \"Si è verificato un errore imprevisto durante l'elaborazione della richiesta. Riprova.\",\n serverRequestFailed:\n \"Impossibile elaborare la richiesta sul server. Riprova.\",\n operationFailed: \"Impossibile completare l'operazione.\",\n },\n fr: {\n loading: \"Traitement en cours...\",\n success: \"Opération terminée avec succès.\",\n unexpectedError:\n \"Une erreur inattendue s'est produite lors du traitement de la demande. Veuillez réessayer.\",\n serverRequestFailed:\n \"Impossible de traiter la demande sur le serveur. Veuillez réessayer.\",\n operationFailed: \"L'opération n'a pas pu être terminée.\",\n },\n} as const satisfies Record<GroovepackLocale, GroovepackLocaleMessages>;\n","import type { GroovepackLocale } from \"@/types/i18n/groovepack-locale.type\";\nimport type { GroovepackLocaleMessages } from \"@/types/i18n/locale-messages.type\";\nimport { getGroovepackLocale } from \"@/i18n/locale-state\";\nimport { GROOVEPACK_MESSAGES } from \"@/i18n/messages\";\n\n/**\n * Returns the localized message dictionary for the given override locale,\n * or the active runtime/environment/default (`\"en\"`) locale.\n */\nexport function resolveLocaleMessages(\n overrideLocale?: GroovepackLocale,\n): GroovepackLocaleMessages {\n const activeLocale = getGroovepackLocale(overrideLocale);\n return GROOVEPACK_MESSAGES[activeLocale];\n}\n"],"mappings":";AAEA,IAAM,uBAAuB,oBAAI,IAAY,CAAC,MAAM,MAAM,MAAM,MAAM,IAAI,CAAC;AAMpE,SAAS,yBACd,WAC8B;AAC9B,MAAI,OAAO,cAAc,UAAU;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,UAAU,KAAK,EAAE,YAAY;AAC7C,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,QAAQ,MAAM,MAAM,EAAE,CAAC;AACvC,MAAI,CAAC,WAAW,CAAC,qBAAqB,IAAI,OAAO,GAAG;AAClD,WAAO;AAAA,EACT;AAEA,SAAO;AACT;;;ACvBA,IAAM,kBAAkB;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,SAAS,qBACP,QAC8B;AAC9B,MAAI,CAAC,QAAQ;AACX,WAAO;AAAA,EACT;AAEA,aAAW,OAAO,iBAAiB;AACjC,UAAM,aAAa,yBAAyB,OAAO,GAAG,CAAC;AACvD,QAAI,YAAY;AACd,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,sBAA2D;AAClE,QAAM,eAAe;AACrB,QAAM,eAAe,aAAa,SAAS;AAC3C,MAAI,OAAO,iBAAiB,YAAY,iBAAiB,MAAM;AAC7D,WAAO;AAAA,EACT;AAEA,QAAM,WAAY,aAAyC,KAAK;AAChE,MAAI,OAAO,aAAa,YAAY,aAAa,MAAM;AACrD,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEA,SAAS,yBAA8D;AACrE,QAAM,YAAY;AAClB,MAAI,OAAO,cAAc,YAAY,cAAc,MAAM;AACvD,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,UAAU,KAAK;AAChC,MAAI,OAAO,aAAa,YAAY,aAAa,MAAM;AACrD,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAOO,SAAS,gBAA8C;AAC5D,SACE,qBAAqB,oBAAoB,CAAC,KAC1C,qBAAqB,uBAAuB,CAAC;AAEjD;;;AC9DA,IAAI;AAOG,SAAS,oBAAoB,QAA4C;AAC9E,MAAI,WAAW,QAAW;AACxB,uBAAmB;AACnB;AAAA,EACF;AAEA,qBAAmB,yBAAyB,MAAM;AACpD;AASO,SAAS,oBACd,gBACkB;AAClB,SACE,yBAAyB,cAAc,KACvC,oBACA,cAAc,KACd;AAEJ;;;ACjCO,IAAM,sBAAsB;AAAA,EACjC,IAAI;AAAA,IACF,SAAS;AAAA,IACT,SAAS;AAAA,IACT,iBACE;AAAA,IACF,qBACE;AAAA,IACF,iBAAiB;AAAA,EACnB;AAAA,EACA,IAAI;AAAA,IACF,SAAS;AAAA,IACT,SAAS;AAAA,IACT,iBACE;AAAA,IACF,qBACE;AAAA,IACF,iBAAiB;AAAA,EACnB;AAAA,EACA,IAAI;AAAA,IACF,SAAS;AAAA,IACT,SAAS;AAAA,IACT,iBACE;AAAA,IACF,qBACE;AAAA,IACF,iBAAiB;AAAA,EACnB;AAAA,EACA,IAAI;AAAA,IACF,SAAS;AAAA,IACT,SAAS;AAAA,IACT,iBACE;AAAA,IACF,qBACE;AAAA,IACF,iBAAiB;AAAA,EACnB;AAAA,EACA,IAAI;AAAA,IACF,SAAS;AAAA,IACT,SAAS;AAAA,IACT,iBACE;AAAA,IACF,qBACE;AAAA,IACF,iBAAiB;AAAA,EACnB;AACF;;;ACxCO,SAAS,sBACd,gBAC0B;AAC1B,QAAM,eAAe,oBAAoB,cAAc;AACvD,SAAO,oBAAoB,YAAY;AACzC;","names":[]}
@@ -0,0 +1,3 @@
1
+ type GroovepackLocale = "en" | "es" | "pt" | "it" | "fr";
2
+
3
+ export type { GroovepackLocale as G };
@@ -0,0 +1,83 @@
1
+ import { G as GroovepackLocale } from '../groovepack-locale.type-CaXo9vLj.js';
2
+
3
+ interface GroovepackLocaleMessages {
4
+ readonly loading: string;
5
+ readonly success: string;
6
+ readonly unexpectedError: string;
7
+ readonly serverRequestFailed: string;
8
+ readonly operationFailed: string;
9
+ }
10
+
11
+ declare const GROOVEPACK_MESSAGES: {
12
+ readonly en: {
13
+ readonly loading: "Processing...";
14
+ readonly success: "Operation completed successfully.";
15
+ readonly unexpectedError: "An unexpected error occurred while processing your request. Please try again.";
16
+ readonly serverRequestFailed: "Could not process the request on the server. Please try again.";
17
+ readonly operationFailed: "The operation could not be completed.";
18
+ };
19
+ readonly es: {
20
+ readonly loading: "Procesando...";
21
+ readonly success: "Operación completada con éxito.";
22
+ readonly unexpectedError: "Ocurrió un error inesperado al procesar la solicitud. Por favor, intenta de nuevo.";
23
+ readonly serverRequestFailed: "No se pudo procesar la solicitud en el servidor. Por favor, intenta de nuevo.";
24
+ readonly operationFailed: "La operación no se pudo completar.";
25
+ };
26
+ readonly pt: {
27
+ readonly loading: "Processando...";
28
+ readonly success: "Operação concluída com sucesso.";
29
+ readonly unexpectedError: "Ocorreu um erro inesperado ao processar a solicitação. Por favor, tente novamente.";
30
+ readonly serverRequestFailed: "Não foi possível processar a solicitação no servidor. Por favor, tente novamente.";
31
+ readonly operationFailed: "Não foi possível concluir a operação.";
32
+ };
33
+ readonly it: {
34
+ readonly loading: "Elaborazione in corso...";
35
+ readonly success: "Operazione completata con successo.";
36
+ readonly unexpectedError: "Si è verificato un errore imprevisto durante l'elaborazione della richiesta. Riprova.";
37
+ readonly serverRequestFailed: "Impossibile elaborare la richiesta sul server. Riprova.";
38
+ readonly operationFailed: "Impossibile completare l'operazione.";
39
+ };
40
+ readonly fr: {
41
+ readonly loading: "Traitement en cours...";
42
+ readonly success: "Opération terminée avec succès.";
43
+ readonly unexpectedError: "Une erreur inattendue s'est produite lors du traitement de la demande. Veuillez réessayer.";
44
+ readonly serverRequestFailed: "Impossible de traiter la demande sur le serveur. Veuillez réessayer.";
45
+ readonly operationFailed: "L'opération n'a pas pu être terminée.";
46
+ };
47
+ };
48
+
49
+ /**
50
+ * Normalizes a candidate locale string (e.g. "es-AR" -> "es") and returns
51
+ * a supported `GroovepackLocale`, or `undefined` if unsupported.
52
+ */
53
+ declare function normalizeSupportedLocale(candidate: unknown): GroovepackLocale | undefined;
54
+
55
+ /**
56
+ * Safely reads `GROOVEPACK_LOCALE` (or framework-prefixed equivalents)
57
+ * across Node.js, Cloudflare Workers, Next.js, Vite, and Astro without
58
+ * requiring `@types/node` or Vite ambient types.
59
+ */
60
+ declare function readEnvLocale(): GroovepackLocale | undefined;
61
+
62
+ /**
63
+ * Sets the global runtime locale for `@3lineas/groovepack` fallback messages.
64
+ * Pass `undefined` to clear the runtime override and fall back to environment
65
+ * variables or `"en"`.
66
+ */
67
+ declare function setGroovepackLocale(locale: GroovepackLocale | undefined): void;
68
+ /**
69
+ * Resolves the active locale using precedence:
70
+ * 1. Explicit `overrideLocale`
71
+ * 2. Runtime locale set via `setGroovepackLocale()`
72
+ * 3. Environment variable (`GROOVEPACK_LOCALE` / framework-prefixed)
73
+ * 4. Default `"en"`
74
+ */
75
+ declare function getGroovepackLocale(overrideLocale?: GroovepackLocale): GroovepackLocale;
76
+
77
+ /**
78
+ * Returns the localized message dictionary for the given override locale,
79
+ * or the active runtime/environment/default (`"en"`) locale.
80
+ */
81
+ declare function resolveLocaleMessages(overrideLocale?: GroovepackLocale): GroovepackLocaleMessages;
82
+
83
+ export { GROOVEPACK_MESSAGES, GroovepackLocale, type GroovepackLocaleMessages, getGroovepackLocale, normalizeSupportedLocale, readEnvLocale, resolveLocaleMessages, setGroovepackLocale };
@@ -0,0 +1,17 @@
1
+ import {
2
+ GROOVEPACK_MESSAGES,
3
+ getGroovepackLocale,
4
+ normalizeSupportedLocale,
5
+ readEnvLocale,
6
+ resolveLocaleMessages,
7
+ setGroovepackLocale
8
+ } from "../chunk-PDWE3D4J.js";
9
+ export {
10
+ GROOVEPACK_MESSAGES,
11
+ getGroovepackLocale,
12
+ normalizeSupportedLocale,
13
+ readEnvLocale,
14
+ resolveLocaleMessages,
15
+ setGroovepackLocale
16
+ };
17
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,19 @@
1
+ type LogContext = Record<string, unknown>;
2
+
3
+ type LogLevel = "INFO" | "WARN" | "ERROR" | "DEBUG";
4
+
5
+ /**
6
+ * Universal structured logger.
7
+ * Outputs ANSI-colored lines in development/test and structured JSON in production.
8
+ */
9
+ declare class Logger {
10
+ private write;
11
+ private emitToConsole;
12
+ info(message: string, context?: LogContext): void;
13
+ warn(message: string, context?: LogContext): void;
14
+ error(message: string, context?: LogContext): void;
15
+ debug(message: string, context?: LogContext): void;
16
+ }
17
+ declare const logger: Logger;
18
+
19
+ export { type LogContext, type LogLevel, logger };