@3lineas/groovepack 0.1.4 → 1.2.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 (42) hide show
  1. package/README.md +261 -138
  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 +52 -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 +80 -0
  10. package/dist/api-toast/index.js +104 -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-3FQ5C44Y.js +119 -0
  14. package/dist/chunk-3FQ5C44Y.js.map +1 -0
  15. package/dist/groovepack-locale.type-CaXo9vLj.d.ts +3 -0
  16. package/dist/i18n/index.d.ts +82 -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 +89 -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 -468
  30. package/dist/index.js.map +0 -1
  31. package/registry/common/api-client/files/README.md.template +0 -64
  32. package/registry/common/api-client/files/index.ts.template +0 -296
  33. package/registry/common/logger/files/README.md.template +0 -55
  34. package/registry/common/logger/files/index.ts.template +0 -194
  35. package/registry/react/api-action/files/README.md.template +0 -61
  36. package/registry/react/api-action/files/index.ts.template +0 -291
  37. package/registry/react/api-toast/files/README.md.template +0 -51
  38. package/registry/react/api-toast/files/index.ts.template +0 -169
  39. package/registry/server/pipeline/files/README.md.template +0 -205
  40. package/registry/server/pipeline/files/pipeline.ts.template +0 -134
  41. package/registry/server/pipeline/files/types.ts.template +0 -35
  42. package/registry/server/pipeline/files/with-d1-transaction.ts.template +0 -50
@@ -0,0 +1,52 @@
1
+ import { Hono } from 'hono';
2
+ import * as hono_utils_types from 'hono/utils/types';
3
+ import * as node_modules_hono_dist_types_client_types from 'node_modules/hono/dist/types/client/types';
4
+
5
+ /**
6
+ * Constraint matching any `Hono<E, S, BasePath>` instance (including
7
+ * routers with custom `Bindings` and `Variables`).
8
+ */
9
+ type AnyHonoApp = Hono<any, any, any>;
10
+
11
+ /**
12
+ * Configuration options for `createApiClient`.
13
+ */
14
+ interface ApiClientConfig {
15
+ /** Base API URL (e.g. `https://api.example.com`). */
16
+ baseUrl?: string;
17
+ /** Storage key used when reading/writing JWTs from `localStorage`. Defaults to `"token"`. */
18
+ tokenStorageKey?: string;
19
+ /** Optional async or sync token provider (e.g. from cookies or session). */
20
+ getToken?: () => string | null | Promise<string | null>;
21
+ /** Additional static headers merged into every request. */
22
+ defaultHeaders?: Record<string, string>;
23
+ /** Custom `fetch` implementation (useful in SSR, Cloudflare Workers, or tests). */
24
+ fetcher?: typeof fetch;
25
+ }
26
+
27
+ /**
28
+ * Standardized REST API client returned by `createApiClient`.
29
+ */
30
+ interface RestApiClient {
31
+ get: (path: string, init?: RequestInit) => Promise<Response>;
32
+ post: (path: string, body?: unknown, init?: RequestInit) => Promise<Response>;
33
+ put: (path: string, body?: unknown, init?: RequestInit) => Promise<Response>;
34
+ patch: (path: string, body?: unknown, init?: RequestInit) => Promise<Response>;
35
+ delete: (path: string, init?: RequestInit) => Promise<Response>;
36
+ setToken: (token: string) => void;
37
+ removeToken: () => void;
38
+ }
39
+
40
+ /**
41
+ * Creates a standardized REST API client with automatic Bearer token injection,
42
+ * `BigInt`-safe JSON serialization, and `FormData` support.
43
+ */
44
+ declare function createApiClient(config?: ApiClientConfig): RestApiClient;
45
+
46
+ /**
47
+ * Creates a typed Hono RPC client (`hc<TApp>()`) with automatic Bearer token injection.
48
+ * Requires `hono` to be installed in the consumer project.
49
+ */
50
+ declare function createHonoClient<TApp extends AnyHonoApp>(config?: ApiClientConfig): hono_utils_types.UnionToIntersection<node_modules_hono_dist_types_client_types.Client<TApp, string>>;
51
+
52
+ export { type AnyHonoApp, 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 { hc } from \"hono/client\";\nimport type { AnyHonoApp } from \"@/types/api-client/any-hono-app.type\";\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<TApp extends AnyHonoApp>(\n config: ApiClientConfig = {},\n) {\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,80 @@
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
+ * Toast payload accepted by `@base-ui/react/toast` (`Toast.createToastManager()`).
6
+ */
7
+ interface BaseUiToastPayload {
8
+ title?: string;
9
+ description?: string;
10
+ type?: "loading" | "success" | "error" | "info" | "warning" | (string & {});
11
+ }
12
+
13
+ /**
14
+ * Contract for `@base-ui/react/toast` manager (`Toast.createToastManager()`).
15
+ */
16
+ interface BaseUiToastManager {
17
+ add: (options: BaseUiToastPayload) => string;
18
+ update: (id: string, updates: BaseUiToastPayload) => void;
19
+ close: (id: string) => void;
20
+ }
21
+
22
+ /**
23
+ * Options for `apiToast`.
24
+ */
25
+ interface ApiToastOptions<T = unknown> {
26
+ /** Async action returning an `ActionResponse<T>`. */
27
+ action: () => Promise<ActionResponse<T>>;
28
+ /** Optional `@base-ui/react/toast` manager instance from `@/components/ui/toast`. */
29
+ toast?: BaseUiToastManager;
30
+ /** Optional locale override (`"en" | "es" | "pt" | "it" | "fr"`). */
31
+ locale?: GroovepackLocale;
32
+ /** Message displayed while the action is pending. */
33
+ loadingMessage?: string;
34
+ /** Fallback message displayed when `action` succeeds without a `message` field. */
35
+ successMessage?: string;
36
+ /** Fallback message displayed when `action` fails without an `error`/`message` field. */
37
+ errorMessage?: string;
38
+ /** Callback invoked when the action resolves with `success: true`. */
39
+ onSuccess?: (data: T | undefined, response: ActionResponse<T>) => void;
40
+ /** Callback invoked when the action resolves with `success: false` or throws. */
41
+ onError?: (error: string, response?: ActionResponse<T>) => void;
42
+ }
43
+
44
+ /**
45
+ * Default configuration for `createApiToast`.
46
+ */
47
+ interface ApiToastDefaults {
48
+ /** Optional `@base-ui/react/toast` manager instance from `@/components/ui/toast`. */
49
+ toast?: BaseUiToastManager;
50
+ /** Optional locale override (`"en" | "es" | "pt" | "it" | "fr"`). */
51
+ locale?: GroovepackLocale;
52
+ /** Default loading message when not specified per call. */
53
+ defaultLoadingMessage?: string;
54
+ /** Default success message when not specified per call. */
55
+ defaultSuccessMessage?: string;
56
+ /** Default error message when not specified per call. */
57
+ defaultErrorMessage?: string;
58
+ }
59
+ type ToastedOptions<T = unknown> = {
60
+ action: () => Promise<ActionResponse<T>>;
61
+ toast?: BaseUiToastManager;
62
+ locale?: GroovepackLocale;
63
+ loadingMessage?: string;
64
+ successMessage?: string;
65
+ errorMessage?: string;
66
+ onSuccess?: (data: T | undefined, response: ActionResponse<T>) => void;
67
+ onError?: (error: string, response?: ActionResponse<T>) => void;
68
+ };
69
+
70
+ /**
71
+ * Factory creating a pre-configured `apiToast` helper backed by Shadcn v4 (`@base-ui/react/toast`).
72
+ */
73
+ declare function createApiToast(defaults?: ApiToastDefaults): <T = unknown>({ action, toast, locale, loadingMessage, successMessage, errorMessage, onSuccess, onError, }: ApiToastOptions<T>) => Promise<ActionResponse<T>>;
74
+
75
+ /**
76
+ * Wraps an `ActionResponse<T>` promise with Shadcn v4 (`@base-ui/react/toast`) loading, success, and error states.
77
+ */
78
+ declare const apiToast: <T = unknown>({ action, toast, locale, loadingMessage, successMessage, errorMessage, onSuccess, onError, }: ApiToastOptions<T>) => Promise<ActionResponse<T>>;
79
+
80
+ export { ActionResponse, type ApiToastDefaults, type ApiToastOptions, type BaseUiToastManager, type BaseUiToastPayload, type ToastedOptions, apiToast, createApiToast };
@@ -0,0 +1,104 @@
1
+ import {
2
+ resolveLocaleMessages
3
+ } from "../chunk-3FQ5C44Y.js";
4
+
5
+ // src/api-toast/resolve-toast-manager.ts
6
+ var MISSING_SHADCN_TOAST_MESSAGE = '[@3lineas/groovepack/api-toast] Shadcn Toast (@base-ui/react/toast) is not installed or configured. Run "pnpm dlx shadcn@latest add toast" and ensure "@base-ui/react" is installed.';
7
+ var defaultToastManager;
8
+ function isValidToastManager(candidate) {
9
+ if (typeof candidate !== "object" || candidate === null) {
10
+ return false;
11
+ }
12
+ const record = candidate;
13
+ return typeof record["add"] === "function" && typeof record["update"] === "function";
14
+ }
15
+ async function resolveToastManager(customToast) {
16
+ if (customToast !== void 0) {
17
+ if (!isValidToastManager(customToast)) {
18
+ console.error(MISSING_SHADCN_TOAST_MESSAGE);
19
+ throw new Error(MISSING_SHADCN_TOAST_MESSAGE);
20
+ }
21
+ return customToast;
22
+ }
23
+ if (defaultToastManager) {
24
+ return defaultToastManager;
25
+ }
26
+ try {
27
+ const baseUiToastModule = await import("@base-ui/react/toast");
28
+ const factory = baseUiToastModule.Toast?.createToastManager ?? baseUiToastModule.createToastManager;
29
+ if (typeof factory !== "function") {
30
+ throw new Error(MISSING_SHADCN_TOAST_MESSAGE);
31
+ }
32
+ const created = factory();
33
+ if (!isValidToastManager(created)) {
34
+ throw new Error(MISSING_SHADCN_TOAST_MESSAGE);
35
+ }
36
+ defaultToastManager = created;
37
+ return defaultToastManager;
38
+ } catch {
39
+ console.error(MISSING_SHADCN_TOAST_MESSAGE);
40
+ throw new Error(MISSING_SHADCN_TOAST_MESSAGE);
41
+ }
42
+ }
43
+
44
+ // src/api-toast/create-api-toast.ts
45
+ function createApiToast(defaults = {}) {
46
+ return async function configuredApiToast({
47
+ action,
48
+ toast = defaults.toast,
49
+ locale = defaults.locale,
50
+ loadingMessage,
51
+ successMessage,
52
+ errorMessage,
53
+ onSuccess,
54
+ onError
55
+ }) {
56
+ const toastManager = await resolveToastManager(toast);
57
+ const messages = resolveLocaleMessages(locale);
58
+ const resolvedLoading = loadingMessage ?? defaults.defaultLoadingMessage ?? messages.loading;
59
+ const resolvedSuccess = successMessage ?? defaults.defaultSuccessMessage ?? messages.success;
60
+ const resolvedError = errorMessage ?? defaults.defaultErrorMessage ?? messages.operationFailed;
61
+ const toastId = toastManager.add({
62
+ title: resolvedLoading,
63
+ type: "loading"
64
+ });
65
+ try {
66
+ const actionResult = await action();
67
+ if (actionResult.success) {
68
+ const displayMessage = actionResult.message ?? resolvedSuccess;
69
+ toastManager.update(toastId, {
70
+ title: displayMessage,
71
+ type: "success"
72
+ });
73
+ onSuccess?.(actionResult.data, actionResult);
74
+ return actionResult;
75
+ }
76
+ const displayError = actionResult.error ?? actionResult.message ?? resolvedError;
77
+ toastManager.update(toastId, {
78
+ title: displayError,
79
+ type: "error"
80
+ });
81
+ onError?.(displayError, actionResult);
82
+ return actionResult;
83
+ } catch (caughtError) {
84
+ const fallbackError = caughtError instanceof Error ? caughtError.message : resolvedError;
85
+ toastManager.update(toastId, {
86
+ title: fallbackError,
87
+ type: "error"
88
+ });
89
+ onError?.(fallbackError);
90
+ return {
91
+ success: false,
92
+ error: fallbackError
93
+ };
94
+ }
95
+ };
96
+ }
97
+
98
+ // src/api-toast/index.ts
99
+ var apiToast = createApiToast();
100
+ export {
101
+ apiToast,
102
+ createApiToast
103
+ };
104
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/api-toast/resolve-toast-manager.ts","../../src/api-toast/create-api-toast.ts","../../src/api-toast/index.ts"],"sourcesContent":["import type { BaseUiToastManager } from \"@/types/api-toast/base-ui-toast-manager.type\";\n\nconst MISSING_SHADCN_TOAST_MESSAGE =\n '[@3lineas/groovepack/api-toast] Shadcn Toast (@base-ui/react/toast) is not installed or configured. Run \"pnpm dlx shadcn@latest add toast\" and ensure \"@base-ui/react\" is installed.';\n\nlet defaultToastManager: BaseUiToastManager | undefined;\n\nfunction isValidToastManager(\n candidate: unknown,\n): candidate is BaseUiToastManager {\n if (typeof candidate !== \"object\" || candidate === null) {\n return false;\n }\n\n const record = candidate as Record<string, unknown>;\n return (\n typeof record[\"add\"] === \"function\" &&\n typeof record[\"update\"] === \"function\"\n );\n}\n\n/**\n * Resolves the active `@base-ui/react/toast` manager or throws a descriptive\n * error when Shadcn Toast (`@base-ui/react/toast`) is not installed.\n */\nexport async function resolveToastManager(\n customToast?: BaseUiToastManager,\n): Promise<BaseUiToastManager> {\n if (customToast !== undefined) {\n if (!isValidToastManager(customToast)) {\n console.error(MISSING_SHADCN_TOAST_MESSAGE);\n throw new Error(MISSING_SHADCN_TOAST_MESSAGE);\n }\n\n return customToast;\n }\n\n if (defaultToastManager) {\n return defaultToastManager;\n }\n\n try {\n const baseUiToastModule = (await import(\"@base-ui/react/toast\")) as {\n Toast?: { createToastManager?: () => BaseUiToastManager };\n createToastManager?: () => BaseUiToastManager;\n };\n const factory =\n baseUiToastModule.Toast?.createToastManager ??\n baseUiToastModule.createToastManager;\n\n if (typeof factory !== \"function\") {\n throw new Error(MISSING_SHADCN_TOAST_MESSAGE);\n }\n\n const created = factory();\n if (!isValidToastManager(created)) {\n throw new Error(MISSING_SHADCN_TOAST_MESSAGE);\n }\n\n defaultToastManager = created;\n return defaultToastManager;\n } catch {\n console.error(MISSING_SHADCN_TOAST_MESSAGE);\n throw new Error(MISSING_SHADCN_TOAST_MESSAGE);\n }\n}\n","import 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 { resolveToastManager } from \"@/api-toast/resolve-toast-manager\";\nimport { resolveLocaleMessages } from \"@/i18n/resolve-locale-messages\";\n\n/**\n * Factory creating a pre-configured `apiToast` helper backed by Shadcn v4 (`@base-ui/react/toast`).\n */\nexport function createApiToast(defaults: ApiToastDefaults = {}) {\n return async function configuredApiToast<T = unknown>({\n action,\n toast = defaults.toast,\n locale = defaults.locale,\n loadingMessage,\n successMessage,\n errorMessage,\n onSuccess,\n onError,\n }: ApiToastOptions<T>): Promise<ActionResponse<T>> {\n const toastManager = await resolveToastManager(toast);\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 = toastManager.add({\n title: resolvedLoading,\n type: \"loading\",\n });\n\n try {\n const actionResult = await action();\n\n if (actionResult.success) {\n const displayMessage = actionResult.message ?? resolvedSuccess;\n toastManager.update(toastId, {\n title: displayMessage,\n type: \"success\",\n });\n onSuccess?.(actionResult.data, actionResult);\n return actionResult;\n }\n\n const displayError =\n actionResult.error ?? actionResult.message ?? resolvedError;\n toastManager.update(toastId, {\n title: displayError,\n type: \"error\",\n });\n onError?.(displayError, actionResult);\n return actionResult;\n } catch (caughtError) {\n const fallbackError =\n caughtError instanceof Error ? caughtError.message : resolvedError;\n toastManager.update(toastId, {\n title: fallbackError,\n type: \"error\",\n });\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 type { BaseUiToastManager } from \"@/types/api-toast/base-ui-toast-manager.type\";\nexport type { BaseUiToastPayload } from \"@/types/api-toast/base-ui-toast-payload.type\";\nexport { createApiToast } from \"@/api-toast/create-api-toast\";\n\n/**\n * Wraps an `ActionResponse<T>` promise with Shadcn v4 (`@base-ui/react/toast`) loading, success, and error states.\n */\nexport const apiToast = createApiToast();\n"],"mappings":";;;;;AAEA,IAAM,+BACJ;AAEF,IAAI;AAEJ,SAAS,oBACP,WACiC;AACjC,MAAI,OAAO,cAAc,YAAY,cAAc,MAAM;AACvD,WAAO;AAAA,EACT;AAEA,QAAM,SAAS;AACf,SACE,OAAO,OAAO,KAAK,MAAM,cACzB,OAAO,OAAO,QAAQ,MAAM;AAEhC;AAMA,eAAsB,oBACpB,aAC6B;AAC7B,MAAI,gBAAgB,QAAW;AAC7B,QAAI,CAAC,oBAAoB,WAAW,GAAG;AACrC,cAAQ,MAAM,4BAA4B;AAC1C,YAAM,IAAI,MAAM,4BAA4B;AAAA,IAC9C;AAEA,WAAO;AAAA,EACT;AAEA,MAAI,qBAAqB;AACvB,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,oBAAqB,MAAM,OAAO,sBAAsB;AAI9D,UAAM,UACJ,kBAAkB,OAAO,sBACzB,kBAAkB;AAEpB,QAAI,OAAO,YAAY,YAAY;AACjC,YAAM,IAAI,MAAM,4BAA4B;AAAA,IAC9C;AAEA,UAAM,UAAU,QAAQ;AACxB,QAAI,CAAC,oBAAoB,OAAO,GAAG;AACjC,YAAM,IAAI,MAAM,4BAA4B;AAAA,IAC9C;AAEA,0BAAsB;AACtB,WAAO;AAAA,EACT,QAAQ;AACN,YAAQ,MAAM,4BAA4B;AAC1C,UAAM,IAAI,MAAM,4BAA4B;AAAA,EAC9C;AACF;;;ACxDO,SAAS,eAAe,WAA6B,CAAC,GAAG;AAC9D,SAAO,eAAe,mBAAgC;AAAA,IACpD;AAAA,IACA,QAAQ,SAAS;AAAA,IACjB,SAAS,SAAS;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAAmD;AACjD,UAAM,eAAe,MAAM,oBAAoB,KAAK;AACpD,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,aAAa,IAAI;AAAA,MAC/B,OAAO;AAAA,MACP,MAAM;AAAA,IACR,CAAC;AAED,QAAI;AACF,YAAM,eAAe,MAAM,OAAO;AAElC,UAAI,aAAa,SAAS;AACxB,cAAM,iBAAiB,aAAa,WAAW;AAC/C,qBAAa,OAAO,SAAS;AAAA,UAC3B,OAAO;AAAA,UACP,MAAM;AAAA,QACR,CAAC;AACD,oBAAY,aAAa,MAAM,YAAY;AAC3C,eAAO;AAAA,MACT;AAEA,YAAM,eACJ,aAAa,SAAS,aAAa,WAAW;AAChD,mBAAa,OAAO,SAAS;AAAA,QAC3B,OAAO;AAAA,QACP,MAAM;AAAA,MACR,CAAC;AACD,gBAAU,cAAc,YAAY;AACpC,aAAO;AAAA,IACT,SAAS,aAAa;AACpB,YAAM,gBACJ,uBAAuB,QAAQ,YAAY,UAAU;AACvD,mBAAa,OAAO,SAAS;AAAA,QAC3B,OAAO;AAAA,QACP,MAAM;AAAA,MACR,CAAC;AACD,gBAAU,aAAa;AAEvB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AACF;;;ACvDO,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,119 @@
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
+ ];
23
+ function readLocaleFromProcessEnv() {
24
+ const globalRecord = globalThis;
25
+ const processValue = globalRecord["process"];
26
+ if (typeof processValue !== "object" || processValue === null) {
27
+ return void 0;
28
+ }
29
+ const envValue = processValue["env"];
30
+ if (typeof envValue !== "object" || envValue === null) {
31
+ return void 0;
32
+ }
33
+ const record = envValue;
34
+ for (const key of ENV_LOCALE_KEYS) {
35
+ const normalized = normalizeSupportedLocale(record[key]);
36
+ if (normalized) {
37
+ return normalized;
38
+ }
39
+ }
40
+ return void 0;
41
+ }
42
+ function readLocaleFromImportMeta() {
43
+ try {
44
+ return normalizeSupportedLocale(import.meta.env?.GROOVEPACK_LOCALE) ?? normalizeSupportedLocale(import.meta.env?.NEXT_PUBLIC_GROOVEPACK_LOCALE);
45
+ } catch {
46
+ return void 0;
47
+ }
48
+ }
49
+ function readEnvLocale() {
50
+ return readLocaleFromProcessEnv() ?? readLocaleFromImportMeta();
51
+ }
52
+
53
+ // src/i18n/locale-state.ts
54
+ var configuredLocale;
55
+ function setGroovepackLocale(locale) {
56
+ if (locale === void 0) {
57
+ configuredLocale = void 0;
58
+ return;
59
+ }
60
+ configuredLocale = normalizeSupportedLocale(locale);
61
+ }
62
+ function getGroovepackLocale(overrideLocale) {
63
+ return normalizeSupportedLocale(overrideLocale) ?? configuredLocale ?? readEnvLocale() ?? "en";
64
+ }
65
+
66
+ // src/i18n/messages.ts
67
+ var GROOVEPACK_MESSAGES = {
68
+ en: {
69
+ loading: "Processing...",
70
+ success: "Operation completed successfully.",
71
+ unexpectedError: "An unexpected error occurred while processing your request. Please try again.",
72
+ serverRequestFailed: "Could not process the request on the server. Please try again.",
73
+ operationFailed: "The operation could not be completed."
74
+ },
75
+ es: {
76
+ loading: "Procesando...",
77
+ success: "Operaci\xF3n completada con \xE9xito.",
78
+ unexpectedError: "Ocurri\xF3 un error inesperado al procesar la solicitud. Por favor, intenta de nuevo.",
79
+ serverRequestFailed: "No se pudo procesar la solicitud en el servidor. Por favor, intenta de nuevo.",
80
+ operationFailed: "La operaci\xF3n no se pudo completar."
81
+ },
82
+ pt: {
83
+ loading: "Processando...",
84
+ success: "Opera\xE7\xE3o conclu\xEDda com sucesso.",
85
+ unexpectedError: "Ocorreu um erro inesperado ao processar a solicita\xE7\xE3o. Por favor, tente novamente.",
86
+ serverRequestFailed: "N\xE3o foi poss\xEDvel processar a solicita\xE7\xE3o no servidor. Por favor, tente novamente.",
87
+ operationFailed: "N\xE3o foi poss\xEDvel concluir a opera\xE7\xE3o."
88
+ },
89
+ it: {
90
+ loading: "Elaborazione in corso...",
91
+ success: "Operazione completata con successo.",
92
+ unexpectedError: "Si \xE8 verificato un errore imprevisto durante l'elaborazione della richiesta. Riprova.",
93
+ serverRequestFailed: "Impossibile elaborare la richiesta sul server. Riprova.",
94
+ operationFailed: "Impossibile completare l'operazione."
95
+ },
96
+ fr: {
97
+ loading: "Traitement en cours...",
98
+ success: "Op\xE9ration termin\xE9e avec succ\xE8s.",
99
+ unexpectedError: "Une erreur inattendue s'est produite lors du traitement de la demande. Veuillez r\xE9essayer.",
100
+ serverRequestFailed: "Impossible de traiter la demande sur le serveur. Veuillez r\xE9essayer.",
101
+ operationFailed: "L'op\xE9ration n'a pas pu \xEAtre termin\xE9e."
102
+ }
103
+ };
104
+
105
+ // src/i18n/resolve-locale-messages.ts
106
+ function resolveLocaleMessages(overrideLocale) {
107
+ const activeLocale = getGroovepackLocale(overrideLocale);
108
+ return GROOVEPACK_MESSAGES[activeLocale];
109
+ }
110
+
111
+ export {
112
+ normalizeSupportedLocale,
113
+ readEnvLocale,
114
+ setGroovepackLocale,
115
+ getGroovepackLocale,
116
+ GROOVEPACK_MESSAGES,
117
+ resolveLocaleMessages
118
+ };
119
+ //# sourceMappingURL=chunk-3FQ5C44Y.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] as const;\n\nfunction readLocaleFromProcessEnv(): GroovepackLocale | 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 const record = envValue as Record<string, unknown>;\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 readLocaleFromImportMeta(): GroovepackLocale | undefined {\n try {\n return (\n normalizeSupportedLocale(import.meta.env?.GROOVEPACK_LOCALE) ??\n normalizeSupportedLocale(import.meta.env?.NEXT_PUBLIC_GROOVEPACK_LOCALE)\n );\n } catch {\n return undefined;\n }\n}\n\n/**\n * Safely reads `GROOVEPACK_LOCALE` or `NEXT_PUBLIC_GROOVEPACK_LOCALE` in Vinext\n * (Cloudflare Workers + Vite 8 `ModuleRunner`) without dynamic `import.meta.env` access.\n */\nexport function readEnvLocale(): GroovepackLocale | undefined {\n return readLocaleFromProcessEnv() ?? readLocaleFromImportMeta();\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;AACF;AAEA,SAAS,2BAAyD;AAChE,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,QAAM,SAAS;AACf,aAAW,OAAO,iBAAiB;AACjC,UAAM,aAAa,yBAAyB,OAAO,GAAG,CAAC;AACvD,QAAI,YAAY;AACd,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,2BAAyD;AAChE,MAAI;AACF,WACE,yBAAyB,YAAY,KAAK,iBAAiB,KAC3D,yBAAyB,YAAY,KAAK,6BAA6B;AAAA,EAE3E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMO,SAAS,gBAA8C;AAC5D,SAAO,yBAAyB,KAAK,yBAAyB;AAChE;;;AC5CA,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,82 @@
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 `NEXT_PUBLIC_GROOVEPACK_LOCALE` in Vinext
57
+ * (Cloudflare Workers + Vite 8 `ModuleRunner`) without dynamic `import.meta.env` access.
58
+ */
59
+ declare function readEnvLocale(): GroovepackLocale | undefined;
60
+
61
+ /**
62
+ * Sets the global runtime locale for `@3lineas/groovepack` fallback messages.
63
+ * Pass `undefined` to clear the runtime override and fall back to environment
64
+ * variables or `"en"`.
65
+ */
66
+ declare function setGroovepackLocale(locale: GroovepackLocale | undefined): void;
67
+ /**
68
+ * Resolves the active locale using precedence:
69
+ * 1. Explicit `overrideLocale`
70
+ * 2. Runtime locale set via `setGroovepackLocale()`
71
+ * 3. Environment variable (`GROOVEPACK_LOCALE` / framework-prefixed)
72
+ * 4. Default `"en"`
73
+ */
74
+ declare function getGroovepackLocale(overrideLocale?: GroovepackLocale): GroovepackLocale;
75
+
76
+ /**
77
+ * Returns the localized message dictionary for the given override locale,
78
+ * or the active runtime/environment/default (`"en"`) locale.
79
+ */
80
+ declare function resolveLocaleMessages(overrideLocale?: GroovepackLocale): GroovepackLocaleMessages;
81
+
82
+ export { GROOVEPACK_MESSAGES, GroovepackLocale, type GroovepackLocaleMessages, getGroovepackLocale, normalizeSupportedLocale, readEnvLocale, resolveLocaleMessages, setGroovepackLocale };