@htlkg/data 0.0.2 → 0.0.3

package/README.md

@@ -0,0 +1,53 @@
+# @htlkg/data
+
+GraphQL client, queries, mutations, hooks, and stores for Hotelinking applications.
+
+## Installation
+
+```bash
+npm install @htlkg/data
+```
+
+## Modules
+
+### [Client](src/client/client.md)
+GraphQL client generation for client-side and server-side data fetching with Amplify.
+
+### [Hooks](src/hooks/README.md)
+Vue composables for reactive data management: `useBrands`, `useAccounts`, `useUsers`, `useProducts`.
+
+### [Queries](src/queries/queries.md)
+GraphQL query functions for accounts, brands, users, and products.
+
+### [Mutations](src/mutations/mutations.md)
+GraphQL mutation functions for creating, updating, and deleting resources.
+
+### [Stores](src/stores/stores.md)
+Nanostore factories for request-scoped state management in Astro SSR.
+
+### [Content Collections](src/content-collections/content-collections.md)
+Astro content collection generators and schema definitions.
+
+## Quick Start
+
+```typescript
+// Client-side data fetching
+import { getSharedClient } from '@htlkg/data/client';
+import type { Schema } from '@backend/data/resource';
+
+const client = getSharedClient<Schema>();
+const { data } = await client.models.Brand.list();
+
+// Vue composables
+import { useBrands, useAccounts } from '@htlkg/data/hooks';
+
+const { brands, loading, error, refetch } = useBrands({
+  accountId: 'account-123',
+  activeOnly: true,
+});
+
+// Server-side queries
+import { fetchBrands, fetchAccounts } from '@htlkg/data/queries';
+
+const brands = await fetchBrands(client, { accountId });
+```

package/dist/client/index.d.ts

@@ -52,6 +52,21 @@ declare function generateServerClientUsingCookies<T extends Record<any, any> = n
  * The server-side functions use the Amplify Astro adapter for proper SSR support.
  */
 
+/**
+ * Get or create the shared GraphQL client instance (singleton pattern)
+ * Use this for client-side fetching to avoid creating multiple client instances.
+ *
+ * @example
+ * ```typescript
+ * const client = getSharedClient<Schema>();
+ * const { data } = await client.models.Account.list();
+ * ```
+ */
+declare function getSharedClient<TSchema extends Record<string, unknown> = Record<string, unknown>>(): ReturnType<typeof generateClient$1<TSchema>>;
+/**
+ * Reset the shared client instance (useful for testing or auth state changes)
+ */
+declare function resetSharedClient(): void;
 /**
  * Generate a client-side GraphQL client for use in Vue components and browser contexts
  * This is SSR-safe and should be called within a component's setup function or after hydration
@@ -138,4 +153,4 @@ interface GenerateServerClientOptions {
  */
 declare function generateServerClient<TSchema extends Record<string, unknown> = Record<string, unknown>>(options?: GenerateServerClientOptions): ReturnType<typeof generateClient$1<TSchema>>;
 
-export { type AstroAmplifyConfig, type GenerateServerClientOptions, type ServerAuthMode, generateClient, generateServerClient, generateServerClientUsingCookies };
+export { type AstroAmplifyConfig, type GenerateServerClientOptions, type ServerAuthMode, generateClient, generateServerClient, generateServerClientUsingCookies, getSharedClient, resetSharedClient };

package/dist/client/index.js

@@ -58,6 +58,16 @@ function generateServerClientUsingCookies(options) {
 }
 
 // src/client/index.ts
+var sharedClientInstance = null;
+function getSharedClient() {
+  if (!sharedClientInstance) {
+    sharedClientInstance = generateDataClient();
+  }
+  return sharedClientInstance;
+}
+function resetSharedClient() {
+  sharedClientInstance = null;
+}
 function generateClient() {
   return generateDataClient();
 }
@@ -68,6 +78,8 @@ function generateServerClient(options) {
 export {
   generateClient,
   generateServerClient,
-  generateServerClientUsingCookies
+  generateServerClientUsingCookies,
+  getSharedClient,
+  resetSharedClient
 };
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/index.ts","../../src/client/server.ts"],"sourcesContent":["/**\n * GraphQL Client for @htlkg/data\n *\n * Provides both client-side and server-side GraphQL capabilities using AWS Amplify Data.\n * The server-side functions use the Amplify Astro adapter for proper SSR support.\n */\n\nimport { generateClient as generateDataClient } from \"aws-amplify/data\";\nimport type { ResourcesConfig } from \"aws-amplify\";\n\n// Re-export server-side client generation\nexport { generateServerClientUsingCookies } from \"./server\";\n\n/**\n * Generate a client-side GraphQL client for use in Vue components and browser contexts\n * This is SSR-safe and should be called within a component's setup function or after hydration\n *\n * @example\n * ```typescript\n * import type { Schema } from '@backend/data/resource';\n * import { generateClient } from '@htlkg/data/client';\n *\n * const client = generateClient<Schema>();\n * const { data: brands } = await client.models.Brand.list();\n * ```\n */\nexport function generateClient<\n\tTSchema extends Record<string, unknown> = Record<string, unknown>,\n>(): ReturnType<typeof generateDataClient<TSchema>> {\n\treturn generateDataClient<TSchema>();\n}\n\n/**\n * Configuration for Amplify (matches amplify_outputs.json format)\n */\nexport type AstroAmplifyConfig = ResourcesConfig;\n\n/**\n * Authentication mode for server-side GraphQL client\n */\nexport type ServerAuthMode = 'userPool' | 'apiKey';\n\n/**\n * Options for generating a server-side GraphQL client\n */\nexport interface GenerateServerClientOptions {\n\t/** Authentication mode - 'userPool' (default) uses JWT from cookies, 'apiKey' uses API key */\n\tauthMode?: ServerAuthMode;\n}\n\n/**\n * Generate a server-side GraphQL client for use within runWithAmplifyServerContext\n * \n * This function creates a GraphQL client that can be used for server-side data fetching in Astro.\n * It MUST be called within runWithAmplifyServerContext to access JWT tokens from cookies.\n * \n * The client supports two authentication modes:\n * - 'userPool' (default): Uses JWT tokens from cookies (requires runWithAmplifyServerContext)\n * - 'apiKey': Uses API key for public/unauthenticated requests\n *\n * **Important**: \n * - Amplify.configure() must be called once at app startup (e.g., in amplify-server.ts)\n * - This function must be called INSIDE the operation function of runWithAmplifyServerContext\n * - The context automatically provides the token provider that reads JWT tokens from cookies\n *\n * @example\n * ```typescript\n * // In your Astro page\n * import type { Schema } from '../amplify/data/resource';\n * import { generateServerClient } from '@htlkg/data/client';\n * import { createRunWithAmplifyServerContext } from '@htlkg/core/amplify-astro-adapter';\n * import outputs from '../amplify_outputs.json';\n *\n * const runWithAmplifyServerContext = createRunWithAmplifyServerContext({ config: outputs });\n *\n * // Fetch data with authentication\n * const result = await runWithAmplifyServerContext({\n *   astroServerContext: {\n *     cookies: Astro.cookies,\n *     request: Astro.request\n *   },\n *   operation: async (contextSpec) => {\n *     // Generate client INSIDE the operation\n *     const client = generateServerClient<Schema>({ authMode: 'userPool' });\n *     return await client.models.User.list();\n *   }\n * });\n * \n * const users = result.data || [];\n * ```\n * \n * @example Using API key for public data\n * ```typescript\n * const result = await runWithAmplifyServerContext({\n *   astroServerContext: {\n *     cookies: Astro.cookies,\n *     request: Astro.request\n *   },\n *   operation: async (contextSpec) => {\n *     const client = generateServerClient<Schema>({ authMode: 'apiKey' });\n *     return await client.models.Brand.list();\n *   }\n * });\n * ```\n */\nexport function generateServerClient<\n\tTSchema extends Record<string, unknown> = Record<string, unknown>,\n>(options?: GenerateServerClientOptions): ReturnType<typeof generateDataClient<TSchema>> {\n\t// Generate the client without authMode parameter\n\t// When called within runWithAmplifyServerContext, it will automatically use the token provider\n\t// from the context (which reads JWT tokens from cookies)\n\t// The authMode should be specified per-operation, not at client creation\n\tconst client = generateDataClient<TSchema>();\n\t\n\treturn client;\n}\n","/**\n * Server-side data client for Astro\n *\n * Provides a client generator similar to Next.js's generateServerClientUsingCookies\n * using generateClientWithAmplifyInstance for proper server context integration.\n */\n\nimport type { AstroGlobal } from \"astro\";\nimport type { ResourcesConfig } from \"aws-amplify\";\nimport {\n\tCommonPublicClientOptions,\n\tDefaultCommonClientOptions,\n\tV6ClientSSRCookies,\n\tgenerateClientWithAmplifyInstance,\n} from \"aws-amplify/api/internals\";\nimport { getAmplifyServerContext } from \"aws-amplify/adapter-core/internals\";\nimport { createRunWithAmplifyServerContext, createLogger } from \"@htlkg/core/amplify-astro-adapter\";\n\nconst log = createLogger('server-client');\n\ninterface AstroCookiesClientParams {\n\tcookies: AstroGlobal[\"cookies\"];\n\trequest: AstroGlobal[\"request\"];\n\tconfig: ResourcesConfig;\n}\n\n/**\n * Generates a server-side data client for Astro (matches Next.js implementation)\n *\n * This function creates a client that automatically wraps all operations in the Amplify server context,\n * ensuring that authentication tokens from cookies are properly used.\n *\n * @example\n * ```typescript\n * import type { Schema } from '../amplify/data/resource';\n * import { generateServerClientUsingCookies } from '@htlkg/data/client';\n * import { parseAmplifyConfig } from 'aws-amplify/utils';\n * import outputs from '../amplify_outputs.json';\n *\n * const amplifyConfig = parseAmplifyConfig(outputs);\n *\n * const client = generateServerClientUsingCookies<Schema>({\n *   config: amplifyConfig,\n *   cookies: Astro.cookies,\n *   request: Astro.request,\n * });\n *\n * // Use the client directly - operations are automatically wrapped\n * const result = await client.models.User.list({\n *   selectionSet: ['id', 'email'],\n *   limit: 100,\n * });\n * ```\n */\nexport function generateServerClientUsingCookies<\n\tT extends Record<any, any> = never,\n\tOptions extends CommonPublicClientOptions &\n\t\tAstroCookiesClientParams = DefaultCommonClientOptions &\n\t\tAstroCookiesClientParams,\n>(options: Options): V6ClientSSRCookies<T, Options> {\n\tconst runWithAmplifyServerContext = createRunWithAmplifyServerContext({\n\t\tconfig: options.config,\n\t});\n\n\tconst resourcesConfig = options.config;\n\n\t// This function reference gets passed down to InternalGraphQLAPI.ts.graphql\n\t// where this._graphql is passed in as the `fn` argument\n\t// causing it to always get invoked inside `runWithAmplifyServerContext`\n\tconst getAmplify = (fn: (amplify: any) => Promise<any>) => {\n\t\treturn runWithAmplifyServerContext({\n\t\t\tastroServerContext: {\n\t\t\t\tcookies: options.cookies,\n\t\t\t\trequest: options.request,\n\t\t\t},\n\t\t\toperation: async (contextSpec: any) => {\n\t\t\t\tconst amplifyInstance = getAmplifyServerContext(contextSpec).amplify;\n\t\t\t\t\n\t\t\t\t// Debug logging (only when DEBUG=true)\n\t\t\t\ttry {\n\t\t\t\t\tconst config = amplifyInstance.getConfig();\n\t\t\t\t\tlog.debug('Amplify config from instance:', {\n\t\t\t\t\t\thasAPI: !!config.API,\n\t\t\t\t\t\thasGraphQL: !!config.API?.GraphQL,\n\t\t\t\t\t\tendpoint: config.API?.GraphQL?.endpoint,\n\t\t\t\t\t\tdefaultAuthMode: config.API?.GraphQL?.defaultAuthMode,\n\t\t\t\t\t\tregion: config.API?.GraphQL?.region,\n\t\t\t\t\t});\n\t\t\t\t\t\n\t\t\t\t\tconst session = await amplifyInstance.Auth.fetchAuthSession();\n\t\t\t\t\tlog.debug('Auth session:', {\n\t\t\t\t\t\thasTokens: !!session.tokens,\n\t\t\t\t\t\thasAccessToken: !!session.tokens?.accessToken,\n\t\t\t\t\t\thasIdToken: !!session.tokens?.idToken,\n\t\t\t\t\t\thasCredentials: !!session.credentials,\n\t\t\t\t\t});\n\t\t\t\t} catch (e: any) {\n\t\t\t\t\tlog.debug('Error fetching session:', e.message);\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\treturn fn(amplifyInstance);\n\t\t\t},\n\t\t});\n\t};\n\n\tconst {\n\t\tcookies: _cookies,\n\t\trequest: _request,\n\t\tconfig: _config,\n\t\t...params\n\t} = options;\n\n\treturn generateClientWithAmplifyInstance<T, V6ClientSSRCookies<T, Options>>({\n\t\tamplify: getAmplify,\n\t\tconfig: resourcesConfig,\n\t\t...params,\n\t} as any);\n}\n"],"mappings":";AAOA,SAAS,kBAAkB,0BAA0B;;;ACErD;AAAA,EAIC;AAAA,OACM;AACP,SAAS,+BAA+B;AACxC,SAAS,mCAAmC,oBAAoB;AAEhE,IAAM,MAAM,aAAa,eAAe;AAoCjC,SAAS,iCAKd,SAAkD;AACnD,QAAM,8BAA8B,kCAAkC;AAAA,IACrE,QAAQ,QAAQ;AAAA,EACjB,CAAC;AAED,QAAM,kBAAkB,QAAQ;AAKhC,QAAM,aAAa,CAAC,OAAuC;AAC1D,WAAO,4BAA4B;AAAA,MAClC,oBAAoB;AAAA,QACnB,SAAS,QAAQ;AAAA,QACjB,SAAS,QAAQ;AAAA,MAClB;AAAA,MACA,WAAW,OAAO,gBAAqB;AACtC,cAAM,kBAAkB,wBAAwB,WAAW,EAAE;AAG7D,YAAI;AACH,gBAAM,SAAS,gBAAgB,UAAU;AACzC,cAAI,MAAM,iCAAiC;AAAA,YAC1C,QAAQ,CAAC,CAAC,OAAO;AAAA,YACjB,YAAY,CAAC,CAAC,OAAO,KAAK;AAAA,YAC1B,UAAU,OAAO,KAAK,SAAS;AAAA,YAC/B,iBAAiB,OAAO,KAAK,SAAS;AAAA,YACtC,QAAQ,OAAO,KAAK,SAAS;AAAA,UAC9B,CAAC;AAED,gBAAM,UAAU,MAAM,gBAAgB,KAAK,iBAAiB;AAC5D,cAAI,MAAM,iBAAiB;AAAA,YAC1B,WAAW,CAAC,CAAC,QAAQ;AAAA,YACrB,gBAAgB,CAAC,CAAC,QAAQ,QAAQ;AAAA,YAClC,YAAY,CAAC,CAAC,QAAQ,QAAQ;AAAA,YAC9B,gBAAgB,CAAC,CAAC,QAAQ;AAAA,UAC3B,CAAC;AAAA,QACF,SAAS,GAAQ;AAChB,cAAI,MAAM,2BAA2B,EAAE,OAAO;AAAA,QAC/C;AAEA,eAAO,GAAG,eAAe;AAAA,MAC1B;AAAA,IACD,CAAC;AAAA,EACF;AAEA,QAAM;AAAA,IACL,SAAS;AAAA,IACT,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,GAAG;AAAA,EACJ,IAAI;AAEJ,SAAO,kCAAqE;AAAA,IAC3E,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,GAAG;AAAA,EACJ,CAAQ;AACT;;;AD3FO,SAAS,iBAEoC;AACnD,SAAO,mBAA4B;AACpC;AA2EO,SAAS,qBAEd,SAAuF;AAKxF,QAAM,SAAS,mBAA4B;AAE3C,SAAO;AACR;","names":[]}
+{"version":3,"sources":["../../src/client/index.ts","../../src/client/server.ts"],"sourcesContent":["/**\n * GraphQL Client for @htlkg/data\n *\n * Provides both client-side and server-side GraphQL capabilities using AWS Amplify Data.\n * The server-side functions use the Amplify Astro adapter for proper SSR support.\n */\n\nimport { generateClient as generateDataClient } from \"aws-amplify/data\";\nimport type { ResourcesConfig } from \"aws-amplify\";\n\n// Re-export server-side client generation\nexport { generateServerClientUsingCookies } from \"./server\";\n\n// Singleton client instance for client-side fetching\nlet sharedClientInstance: any = null;\n\n/**\n * Get or create the shared GraphQL client instance (singleton pattern)\n * Use this for client-side fetching to avoid creating multiple client instances.\n *\n * @example\n * ```typescript\n * const client = getSharedClient<Schema>();\n * const { data } = await client.models.Account.list();\n * ```\n */\nexport function getSharedClient<\n\tTSchema extends Record<string, unknown> = Record<string, unknown>,\n>(): ReturnType<typeof generateDataClient<TSchema>> {\n\tif (!sharedClientInstance) {\n\t\tsharedClientInstance = generateDataClient<TSchema>();\n\t}\n\treturn sharedClientInstance;\n}\n\n/**\n * Reset the shared client instance (useful for testing or auth state changes)\n */\nexport function resetSharedClient(): void {\n\tsharedClientInstance = null;\n}\n\n/**\n * Generate a client-side GraphQL client for use in Vue components and browser contexts\n * This is SSR-safe and should be called within a component's setup function or after hydration\n *\n * @example\n * ```typescript\n * import type { Schema } from '@backend/data/resource';\n * import { generateClient } from '@htlkg/data/client';\n *\n * const client = generateClient<Schema>();\n * const { data: brands } = await client.models.Brand.list();\n * ```\n */\nexport function generateClient<\n\tTSchema extends Record<string, unknown> = Record<string, unknown>,\n>(): ReturnType<typeof generateDataClient<TSchema>> {\n\treturn generateDataClient<TSchema>();\n}\n\n/**\n * Configuration for Amplify (matches amplify_outputs.json format)\n */\nexport type AstroAmplifyConfig = ResourcesConfig;\n\n/**\n * Authentication mode for server-side GraphQL client\n */\nexport type ServerAuthMode = 'userPool' | 'apiKey';\n\n/**\n * Options for generating a server-side GraphQL client\n */\nexport interface GenerateServerClientOptions {\n\t/** Authentication mode - 'userPool' (default) uses JWT from cookies, 'apiKey' uses API key */\n\tauthMode?: ServerAuthMode;\n}\n\n/**\n * Generate a server-side GraphQL client for use within runWithAmplifyServerContext\n * \n * This function creates a GraphQL client that can be used for server-side data fetching in Astro.\n * It MUST be called within runWithAmplifyServerContext to access JWT tokens from cookies.\n * \n * The client supports two authentication modes:\n * - 'userPool' (default): Uses JWT tokens from cookies (requires runWithAmplifyServerContext)\n * - 'apiKey': Uses API key for public/unauthenticated requests\n *\n * **Important**: \n * - Amplify.configure() must be called once at app startup (e.g., in amplify-server.ts)\n * - This function must be called INSIDE the operation function of runWithAmplifyServerContext\n * - The context automatically provides the token provider that reads JWT tokens from cookies\n *\n * @example\n * ```typescript\n * // In your Astro page\n * import type { Schema } from '../amplify/data/resource';\n * import { generateServerClient } from '@htlkg/data/client';\n * import { createRunWithAmplifyServerContext } from '@htlkg/core/amplify-astro-adapter';\n * import outputs from '../amplify_outputs.json';\n *\n * const runWithAmplifyServerContext = createRunWithAmplifyServerContext({ config: outputs });\n *\n * // Fetch data with authentication\n * const result = await runWithAmplifyServerContext({\n *   astroServerContext: {\n *     cookies: Astro.cookies,\n *     request: Astro.request\n *   },\n *   operation: async (contextSpec) => {\n *     // Generate client INSIDE the operation\n *     const client = generateServerClient<Schema>({ authMode: 'userPool' });\n *     return await client.models.User.list();\n *   }\n * });\n * \n * const users = result.data || [];\n * ```\n * \n * @example Using API key for public data\n * ```typescript\n * const result = await runWithAmplifyServerContext({\n *   astroServerContext: {\n *     cookies: Astro.cookies,\n *     request: Astro.request\n *   },\n *   operation: async (contextSpec) => {\n *     const client = generateServerClient<Schema>({ authMode: 'apiKey' });\n *     return await client.models.Brand.list();\n *   }\n * });\n * ```\n */\nexport function generateServerClient<\n\tTSchema extends Record<string, unknown> = Record<string, unknown>,\n>(options?: GenerateServerClientOptions): ReturnType<typeof generateDataClient<TSchema>> {\n\t// Generate the client without authMode parameter\n\t// When called within runWithAmplifyServerContext, it will automatically use the token provider\n\t// from the context (which reads JWT tokens from cookies)\n\t// The authMode should be specified per-operation, not at client creation\n\tconst client = generateDataClient<TSchema>();\n\t\n\treturn client;\n}\n","/**\n * Server-side data client for Astro\n *\n * Provides a client generator similar to Next.js's generateServerClientUsingCookies\n * using generateClientWithAmplifyInstance for proper server context integration.\n */\n\nimport type { AstroGlobal } from \"astro\";\nimport type { ResourcesConfig } from \"aws-amplify\";\nimport {\n\tCommonPublicClientOptions,\n\tDefaultCommonClientOptions,\n\tV6ClientSSRCookies,\n\tgenerateClientWithAmplifyInstance,\n} from \"aws-amplify/api/internals\";\nimport { getAmplifyServerContext } from \"aws-amplify/adapter-core/internals\";\nimport { createRunWithAmplifyServerContext, createLogger } from \"@htlkg/core/amplify-astro-adapter\";\n\nconst log = createLogger('server-client');\n\ninterface AstroCookiesClientParams {\n\tcookies: AstroGlobal[\"cookies\"];\n\trequest: AstroGlobal[\"request\"];\n\tconfig: ResourcesConfig;\n}\n\n/**\n * Generates a server-side data client for Astro (matches Next.js implementation)\n *\n * This function creates a client that automatically wraps all operations in the Amplify server context,\n * ensuring that authentication tokens from cookies are properly used.\n *\n * @example\n * ```typescript\n * import type { Schema } from '../amplify/data/resource';\n * import { generateServerClientUsingCookies } from '@htlkg/data/client';\n * import { parseAmplifyConfig } from 'aws-amplify/utils';\n * import outputs from '../amplify_outputs.json';\n *\n * const amplifyConfig = parseAmplifyConfig(outputs);\n *\n * const client = generateServerClientUsingCookies<Schema>({\n *   config: amplifyConfig,\n *   cookies: Astro.cookies,\n *   request: Astro.request,\n * });\n *\n * // Use the client directly - operations are automatically wrapped\n * const result = await client.models.User.list({\n *   selectionSet: ['id', 'email'],\n *   limit: 100,\n * });\n * ```\n */\nexport function generateServerClientUsingCookies<\n\tT extends Record<any, any> = never,\n\tOptions extends CommonPublicClientOptions &\n\t\tAstroCookiesClientParams = DefaultCommonClientOptions &\n\t\tAstroCookiesClientParams,\n>(options: Options): V6ClientSSRCookies<T, Options> {\n\tconst runWithAmplifyServerContext = createRunWithAmplifyServerContext({\n\t\tconfig: options.config,\n\t});\n\n\tconst resourcesConfig = options.config;\n\n\t// This function reference gets passed down to InternalGraphQLAPI.ts.graphql\n\t// where this._graphql is passed in as the `fn` argument\n\t// causing it to always get invoked inside `runWithAmplifyServerContext`\n\tconst getAmplify = (fn: (amplify: any) => Promise<any>) => {\n\t\treturn runWithAmplifyServerContext({\n\t\t\tastroServerContext: {\n\t\t\t\tcookies: options.cookies,\n\t\t\t\trequest: options.request,\n\t\t\t},\n\t\t\toperation: async (contextSpec: any) => {\n\t\t\t\tconst amplifyInstance = getAmplifyServerContext(contextSpec).amplify;\n\t\t\t\t\n\t\t\t\t// Debug logging (only when DEBUG=true)\n\t\t\t\ttry {\n\t\t\t\t\tconst config = amplifyInstance.getConfig();\n\t\t\t\t\tlog.debug('Amplify config from instance:', {\n\t\t\t\t\t\thasAPI: !!config.API,\n\t\t\t\t\t\thasGraphQL: !!config.API?.GraphQL,\n\t\t\t\t\t\tendpoint: config.API?.GraphQL?.endpoint,\n\t\t\t\t\t\tdefaultAuthMode: config.API?.GraphQL?.defaultAuthMode,\n\t\t\t\t\t\tregion: config.API?.GraphQL?.region,\n\t\t\t\t\t});\n\t\t\t\t\t\n\t\t\t\t\tconst session = await amplifyInstance.Auth.fetchAuthSession();\n\t\t\t\t\tlog.debug('Auth session:', {\n\t\t\t\t\t\thasTokens: !!session.tokens,\n\t\t\t\t\t\thasAccessToken: !!session.tokens?.accessToken,\n\t\t\t\t\t\thasIdToken: !!session.tokens?.idToken,\n\t\t\t\t\t\thasCredentials: !!session.credentials,\n\t\t\t\t\t});\n\t\t\t\t} catch (e: any) {\n\t\t\t\t\tlog.debug('Error fetching session:', e.message);\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\treturn fn(amplifyInstance);\n\t\t\t},\n\t\t});\n\t};\n\n\tconst {\n\t\tcookies: _cookies,\n\t\trequest: _request,\n\t\tconfig: _config,\n\t\t...params\n\t} = options;\n\n\treturn generateClientWithAmplifyInstance<T, V6ClientSSRCookies<T, Options>>({\n\t\tamplify: getAmplify,\n\t\tconfig: resourcesConfig,\n\t\t...params,\n\t} as any);\n}\n"],"mappings":";AAOA,SAAS,kBAAkB,0BAA0B;;;ACErD;AAAA,EAIC;AAAA,OACM;AACP,SAAS,+BAA+B;AACxC,SAAS,mCAAmC,oBAAoB;AAEhE,IAAM,MAAM,aAAa,eAAe;AAoCjC,SAAS,iCAKd,SAAkD;AACnD,QAAM,8BAA8B,kCAAkC;AAAA,IACrE,QAAQ,QAAQ;AAAA,EACjB,CAAC;AAED,QAAM,kBAAkB,QAAQ;AAKhC,QAAM,aAAa,CAAC,OAAuC;AAC1D,WAAO,4BAA4B;AAAA,MAClC,oBAAoB;AAAA,QACnB,SAAS,QAAQ;AAAA,QACjB,SAAS,QAAQ;AAAA,MAClB;AAAA,MACA,WAAW,OAAO,gBAAqB;AACtC,cAAM,kBAAkB,wBAAwB,WAAW,EAAE;AAG7D,YAAI;AACH,gBAAM,SAAS,gBAAgB,UAAU;AACzC,cAAI,MAAM,iCAAiC;AAAA,YAC1C,QAAQ,CAAC,CAAC,OAAO;AAAA,YACjB,YAAY,CAAC,CAAC,OAAO,KAAK;AAAA,YAC1B,UAAU,OAAO,KAAK,SAAS;AAAA,YAC/B,iBAAiB,OAAO,KAAK,SAAS;AAAA,YACtC,QAAQ,OAAO,KAAK,SAAS;AAAA,UAC9B,CAAC;AAED,gBAAM,UAAU,MAAM,gBAAgB,KAAK,iBAAiB;AAC5D,cAAI,MAAM,iBAAiB;AAAA,YAC1B,WAAW,CAAC,CAAC,QAAQ;AAAA,YACrB,gBAAgB,CAAC,CAAC,QAAQ,QAAQ;AAAA,YAClC,YAAY,CAAC,CAAC,QAAQ,QAAQ;AAAA,YAC9B,gBAAgB,CAAC,CAAC,QAAQ;AAAA,UAC3B,CAAC;AAAA,QACF,SAAS,GAAQ;AAChB,cAAI,MAAM,2BAA2B,EAAE,OAAO;AAAA,QAC/C;AAEA,eAAO,GAAG,eAAe;AAAA,MAC1B;AAAA,IACD,CAAC;AAAA,EACF;AAEA,QAAM;AAAA,IACL,SAAS;AAAA,IACT,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,GAAG;AAAA,EACJ,IAAI;AAEJ,SAAO,kCAAqE;AAAA,IAC3E,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,GAAG;AAAA,EACJ,CAAQ;AACT;;;ADvGA,IAAI,uBAA4B;AAYzB,SAAS,kBAEoC;AACnD,MAAI,CAAC,sBAAsB;AAC1B,2BAAuB,mBAA4B;AAAA,EACpD;AACA,SAAO;AACR;AAKO,SAAS,oBAA0B;AACzC,yBAAuB;AACxB;AAeO,SAAS,iBAEoC;AACnD,SAAO,mBAA4B;AACpC;AA2EO,SAAS,qBAEd,SAAuF;AAKxF,QAAM,SAAS,mBAA4B;AAE3C,SAAO;AACR;","names":[]}

package/dist/hooks/index.d.ts

@@ -1,5 +1,113 @@
 import { Ref, ComputedRef } from 'vue';
 import { Brand, Account, User, Product } from '@htlkg/core/types';
+export { resetSharedClient as resetClientInstance } from '../client/index.js';
+import 'aws-amplify/data';
+import 'aws-amplify';
+import 'astro';
+import 'aws-amplify/api/internals';
+
+/**
+ * Data Hook Factory
+ *
+ * Creates reusable Vue composables for fetching data from GraphQL models.
+ * Provides a DRY approach to data fetching with consistent patterns.
+ */
+
+/**
+ * Configuration options for creating a data hook
+ */
+interface CreateDataHookOptions<T, TOptions extends BaseHookOptions = BaseHookOptions> {
+    /** The GraphQL model name (e.g., 'Account', 'User', 'Brand') */
+    model: string;
+    /** Default limit for queries */
+    defaultLimit?: number;
+    /** Selection set for the query (fields to fetch) */
+    selectionSet?: string[];
+    /** Transform function to apply to fetched data */
+    transform?: (item: any) => T;
+    /** Build filter from hook options */
+    buildFilter?: (options: TOptions) => any;
+    /** Define computed properties based on the data */
+    computedProperties?: Record<string, (data: T[]) => any>;
+    /** Plural name for the data property (e.g., 'accounts', 'users') */
+    dataPropertyName?: string;
+}
+/**
+ * Base options available to all hooks
+ */
+interface BaseHookOptions {
+    /** Filter criteria */
+    filter?: any;
+    /** Limit number of results */
+    limit?: number;
+    /** Auto-fetch on mount (default: true) */
+    autoFetch?: boolean;
+}
+/**
+ * Return type for data hooks
+ */
+interface DataHookReturn<T, TComputed extends Record<string, any> = Record<string, never>> {
+    /** Reactive array of data */
+    data: Ref<T[]>;
+    /** Loading state */
+    loading: Ref<boolean>;
+    /** Error state */
+    error: Ref<Error | null>;
+    /** Refetch data */
+    refetch: () => Promise<void>;
+    /** Computed properties */
+    computed: {
+        [K in keyof TComputed]: ComputedRef<TComputed[K]>;
+    };
+}
+
+/**
+ * Creates a reusable data hook for a specific model
+ *
+ * @example
+ * ```typescript
+ * // Create a simple hook
+ * export const useAccounts = createDataHook<Account>({
+ *   model: 'Account',
+ *   dataPropertyName: 'accounts',
+ * });
+ *
+ * // Usage
+ * const { data: accounts, loading, error, refetch } = useAccounts();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Create a hook with custom filters and computed properties
+ * interface UseBrandsOptions extends BaseHookOptions {
+ *   accountId?: string;
+ *   activeOnly?: boolean;
+ * }
+ *
+ * export const useBrands = createDataHook<Brand, UseBrandsOptions>({
+ *   model: 'Brand',
+ *   dataPropertyName: 'brands',
+ *   buildFilter: (options) => {
+ *     const filter: any = options.filter || {};
+ *     if (options.accountId) filter.accountId = { eq: options.accountId };
+ *     if (options.activeOnly) filter.status = { eq: 'active' };
+ *     return Object.keys(filter).length > 0 ? filter : undefined;
+ *   },
+ *   computedProperties: {
+ *     activeBrands: (brands) => brands.filter(b => b.status === 'active'),
+ *   },
+ * });
+ * ```
+ */
+declare function createDataHook<T, TOptions extends BaseHookOptions = BaseHookOptions, TComputed extends Record<string, any> = Record<string, never>>(config: CreateDataHookOptions<T, TOptions> & {
+    computedProperties?: {
+        [K in keyof TComputed]: (data: T[]) => TComputed[K];
+    };
+}): (options?: TOptions) => DataHookReturn<T, TComputed> & Record<string, any>;
+/**
+ * Type helper to extract the return type of a created hook
+ */
+type InferHookReturn<THook extends (...args: any[]) => any> = ReturnType<THook>;
 
 /**
  * useBrands Hook
@@ -8,7 +116,7 @@ import { Brand, Account, User, Product } from '@htlkg/core/types';
  * Provides loading states, error handling, and refetch capabilities.
  */
 
-interface UseBrandsOptions {
+interface UseBrandsOptions extends BaseHookOptions {
     /** Filter criteria for brands */
     filter?: any;
     /** Limit number of results */
@@ -60,7 +168,7 @@ declare function useBrands(options?: UseBrandsOptions): UseBrandsReturn;
  * Provides loading states, error handling, and refetch capabilities.
  */
 
-interface UseAccountsOptions {
+interface UseAccountsOptions extends BaseHookOptions {
     /** Filter criteria for accounts */
     filter?: any;
     /** Limit number of results */
@@ -105,7 +213,7 @@ declare function useAccounts(options?: UseAccountsOptions): UseAccountsReturn;
  * Provides loading states, error handling, and refetch capabilities.
  */
 
-interface UseUsersOptions {
+interface UseUsersOptions extends BaseHookOptions {
     /** Filter criteria for users */
     filter?: any;
     /** Limit number of results */
@@ -155,7 +263,7 @@ declare function useUsers(options?: UseUsersOptions): UseUsersReturn;
  * Provides loading states, error handling, and refetch capabilities.
  */
 
-interface UseProductsOptions {
+interface UseProductsOptions extends BaseHookOptions {
     /** Filter criteria for products */
     filter?: any;
     /** Limit number of results */
@@ -197,4 +305,4 @@ interface UseProductsReturn {
  */
 declare function useProducts(options?: UseProductsOptions): UseProductsReturn;
 
-export { type UseAccountsOptions, type UseAccountsReturn, type UseBrandsOptions, type UseBrandsReturn, type UseProductsOptions, type UseProductsReturn, type UseUsersOptions, type UseUsersReturn, useAccounts, useBrands, useProducts, useUsers };
+export { type BaseHookOptions, type CreateDataHookOptions, type DataHookReturn, type InferHookReturn, type UseAccountsOptions, type UseAccountsReturn, type UseBrandsOptions, type UseBrandsReturn, type UseProductsOptions, type UseProductsReturn, type UseUsersOptions, type UseUsersReturn, createDataHook, useAccounts, useBrands, useProducts, useUsers };

package/dist/hooks/index.js

@@ -1,4 +1,4 @@
-// src/hooks/useBrands.ts
+// src/hooks/createDataHook.ts
 import { ref, computed, onMounted } from "vue";
 
 // src/client/index.ts
@@ -13,201 +13,192 @@ import { createRunWithAmplifyServerContext, createLogger } from "@htlkg/core/amp
 var log = createLogger("server-client");
 
 // src/client/index.ts
-function generateClient() {
-  return generateDataClient();
+var sharedClientInstance = null;
+function getSharedClient() {
+  if (!sharedClientInstance) {
+    sharedClientInstance = generateDataClient();
+  }
+  return sharedClientInstance;
+}
+function resetSharedClient() {
+  sharedClientInstance = null;
 }
 
-// src/hooks/useBrands.ts
-function useBrands(options = {}) {
+// src/hooks/createDataHook.ts
+function createDataHook(config) {
   const {
-    filter: baseFilter,
-    limit,
-    autoFetch = true,
-    accountId,
-    activeOnly
-  } = options;
-  const brands = ref([]);
-  const loading = ref(false);
-  const error = ref(null);
-  let filter = baseFilter || {};
-  if (accountId) {
-    filter = { ...filter, accountId: { eq: accountId } };
-  }
-  if (activeOnly) {
-    filter = { ...filter, status: { eq: "active" } };
-  }
-  const activeBrands = computed(
-    () => brands.value.filter((b) => b.status === "active")
-  );
-  async function fetch() {
-    loading.value = true;
-    error.value = null;
-    try {
-      const client = generateClient();
-      const { data, errors } = await client.models.Brand.list({
-        filter: Object.keys(filter).length > 0 ? filter : void 0,
-        limit
-      });
-      if (errors) {
-        throw new Error(errors[0]?.message || "Failed to fetch brands");
+    model,
+    defaultLimit,
+    selectionSet,
+    transform,
+    buildFilter: buildFilter4,
+    computedProperties,
+    dataPropertyName = "data"
+  } = config;
+  return function useData(options = {}) {
+    const { filter: baseFilter, limit = defaultLimit, autoFetch = true } = options;
+    const data = ref([]);
+    const loading = ref(false);
+    const error = ref(null);
+    const getFilter = () => {
+      if (buildFilter4) {
+        return buildFilter4(options);
+      }
+      return baseFilter && Object.keys(baseFilter).length > 0 ? baseFilter : void 0;
+    };
+    async function fetch() {
+      loading.value = true;
+      error.value = null;
+      try {
+        const client = getSharedClient();
+        const queryOptions = {
+          filter: getFilter(),
+          limit
+        };
+        if (selectionSet) {
+          queryOptions.selectionSet = selectionSet;
+        }
+        const { data: responseData, errors } = await client.models[model].list(queryOptions);
+        if (errors) {
+          throw new Error(errors[0]?.message || `Failed to fetch ${model}`);
+        }
+        const items = responseData || [];
+        data.value = transform ? items.map(transform) : items;
+      } catch (e) {
+        error.value = e;
+        console.error(`[use${model}] Error fetching ${model}:`, e);
+      } finally {
+        loading.value = false;
+      }
+    }
+    const computedRefs = {};
+    if (computedProperties) {
+      for (const [key, fn] of Object.entries(computedProperties)) {
+        computedRefs[key] = computed(() => fn(data.value));
       }
-      brands.value = data || [];
-    } catch (e) {
-      error.value = e;
-      console.error("[useBrands] Error fetching brands:", e);
-    } finally {
-      loading.value = false;
     }
+    if (autoFetch) {
+      onMounted(() => {
+        fetch();
+      });
+    }
+    const result = {
+      data,
+      loading,
+      error,
+      refetch: fetch,
+      computed: computedRefs
+    };
+    if (dataPropertyName !== "data") {
+      result[dataPropertyName] = data;
+    }
+    for (const [key, computedRef] of Object.entries(computedRefs)) {
+      result[key] = computedRef;
+    }
+    return result;
+  };
+}
+
+// src/hooks/useBrands.ts
+function buildFilter(options) {
+  let filter = options.filter || {};
+  if (options.accountId) {
+    filter = { ...filter, accountId: { eq: options.accountId } };
+  }
+  if (options.activeOnly) {
+    filter = { ...filter, status: { eq: "active" } };
   }
-  if (autoFetch) {
-    onMounted(() => {
-      fetch();
-    });
+  return Object.keys(filter).length > 0 ? filter : void 0;
+}
+var useBrandsInternal = createDataHook({
+  model: "Brand",
+  dataPropertyName: "brands",
+  buildFilter,
+  computedProperties: {
+    activeBrands: (brands) => brands.filter((b) => b.status === "active")
   }
+});
+function useBrands(options = {}) {
+  const result = useBrandsInternal(options);
   return {
-    brands,
-    activeBrands,
-    loading,
-    error,
-    refetch: fetch
+    brands: result.brands,
+    activeBrands: result.activeBrands,
+    loading: result.loading,
+    error: result.error,
+    refetch: result.refetch
   };
 }
 
 // src/hooks/useAccounts.ts
-import { ref as ref2, onMounted as onMounted2 } from "vue";
+var useAccountsInternal = createDataHook({
+  model: "Account",
+  dataPropertyName: "accounts"
+});
 function useAccounts(options = {}) {
-  const { filter, limit, autoFetch = true } = options;
-  const accounts = ref2([]);
-  const loading = ref2(false);
-  const error = ref2(null);
-  async function fetch() {
-    loading.value = true;
-    error.value = null;
-    try {
-      const client = generateClient();
-      const { data, errors } = await client.models.Account.list({
-        filter,
-        limit
-      });
-      if (errors) {
-        throw new Error(errors[0]?.message || "Failed to fetch accounts");
-      }
-      accounts.value = data || [];
-    } catch (e) {
-      error.value = e;
-      console.error("[useAccounts] Error fetching accounts:", e);
-    } finally {
-      loading.value = false;
-    }
-  }
-  if (autoFetch) {
-    onMounted2(() => {
-      fetch();
-    });
-  }
+  const result = useAccountsInternal(options);
   return {
-    accounts,
-    loading,
-    error,
-    refetch: fetch
+    accounts: result.accounts,
+    loading: result.loading,
+    error: result.error,
+    refetch: result.refetch
   };
 }
 
 // src/hooks/useUsers.ts
-import { ref as ref3, onMounted as onMounted3 } from "vue";
-function useUsers(options = {}) {
-  const { filter: baseFilter, limit, autoFetch = true, brandId, accountId } = options;
-  const users = ref3([]);
-  const loading = ref3(false);
-  const error = ref3(null);
-  let filter = baseFilter || {};
-  if (brandId) {
-    filter = { ...filter, brandIds: { contains: brandId } };
-  }
-  if (accountId) {
-    filter = { ...filter, accountIds: { contains: accountId } };
-  }
-  async function fetch() {
-    loading.value = true;
-    error.value = null;
-    try {
-      const client = generateClient();
-      const { data, errors } = await client.models.User.list({
-        filter: Object.keys(filter).length > 0 ? filter : void 0,
-        limit
-      });
-      if (errors) {
-        throw new Error(errors[0]?.message || "Failed to fetch users");
-      }
-      users.value = data || [];
-    } catch (e) {
-      error.value = e;
-      console.error("[useUsers] Error fetching users:", e);
-    } finally {
-      loading.value = false;
-    }
+function buildFilter2(options) {
+  let filter = options.filter || {};
+  if (options.brandId) {
+    filter = { ...filter, brandIds: { contains: options.brandId } };
   }
-  if (autoFetch) {
-    onMounted3(() => {
-      fetch();
-    });
+  if (options.accountId) {
+    filter = { ...filter, accountIds: { contains: options.accountId } };
   }
+  return Object.keys(filter).length > 0 ? filter : void 0;
+}
+var useUsersInternal = createDataHook({
+  model: "User",
+  dataPropertyName: "users",
+  buildFilter: buildFilter2
+});
+function useUsers(options = {}) {
+  const result = useUsersInternal(options);
   return {
-    users,
-    loading,
-    error,
-    refetch: fetch
+    users: result.users,
+    loading: result.loading,
+    error: result.error,
+    refetch: result.refetch
   };
 }
 
 // src/hooks/useProducts.ts
-import { ref as ref4, computed as computed2, onMounted as onMounted4 } from "vue";
-function useProducts(options = {}) {
-  const { filter: baseFilter, limit, autoFetch = true, activeOnly } = options;
-  const products = ref4([]);
-  const loading = ref4(false);
-  const error = ref4(null);
-  let filter = baseFilter || {};
-  if (activeOnly) {
+function buildFilter3(options) {
+  let filter = options.filter || {};
+  if (options.activeOnly) {
     filter = { ...filter, isActive: { eq: true } };
   }
-  const activeProducts = computed2(
-    () => products.value.filter((p) => p.isActive === true)
-  );
-  async function fetch() {
-    loading.value = true;
-    error.value = null;
-    try {
-      const client = generateClient();
-      const { data, errors } = await client.models.Product.list({
-        filter: Object.keys(filter).length > 0 ? filter : void 0,
-        limit
-      });
-      if (errors) {
-        throw new Error(errors[0]?.message || "Failed to fetch products");
-      }
-      products.value = data || [];
-    } catch (e) {
-      error.value = e;
-      console.error("[useProducts] Error fetching products:", e);
-    } finally {
-      loading.value = false;
-    }
-  }
-  if (autoFetch) {
-    onMounted4(() => {
-      fetch();
-    });
+  return Object.keys(filter).length > 0 ? filter : void 0;
+}
+var useProductsInternal = createDataHook({
+  model: "Product",
+  dataPropertyName: "products",
+  buildFilter: buildFilter3,
+  computedProperties: {
+    activeProducts: (products) => products.filter((p) => p.isActive === true)
   }
+});
+function useProducts(options = {}) {
+  const result = useProductsInternal(options);
   return {
-    products,
-    activeProducts,
-    loading,
-    error,
-    refetch: fetch
+    products: result.products,
+    activeProducts: result.activeProducts,
+    loading: result.loading,
+    error: result.error,
+    refetch: result.refetch
   };
 }
 export {
+  createDataHook,
+  resetSharedClient as resetClientInstance,
   useAccounts,
   useBrands,
   useProducts,