@htlkg/data 0.0.14 → 0.0.16

package/README.md

@@ -30,6 +30,39 @@ Astro content collection generators and schema definitions.
 
 ## Quick Start
 
+### Server-Side (Astro Pages) - Zero Config (Recommended)
+
+When using `@htlkg/astro` integration, the Amplify client is **automatically injected** into `Astro.locals.amplifyClient` by the auth middleware. No imports, no config needed:
+
+```typescript
+---
+// In any Astro page (.astro file)
+export const prerender = false;
+
+// Just use it - no imports needed for client setup!
+const { amplifyClient } = Astro.locals;
+
+// Fetch data directly
+const { data: users } = await amplifyClient.models.User.list({
+  selectionSet: ['id', 'email', 'status'],
+  authMode: 'userPool',
+});
+
+const { data: brands } = await amplifyClient.models.Brand.list();
+---
+
+<ul>
+  {users?.map(user => <li>{user.email}</li>)}
+</ul>
+```
+
+**Requirements:**
+- Must use `@htlkg/astro` integration with `vueAppSetup: 'full'`
+- User must be authenticated (client is only available when `Astro.locals.user` exists)
+- Page must have `export const prerender = false` (SSR mode)
+
+### Client-Side (Vue Components)
+
 ```typescript
 // Client-side data fetching
 import { getSharedClient } from '@htlkg/data/client';
@@ -51,3 +84,42 @@ import { fetchBrands, fetchAccounts } from '@htlkg/data/queries';
 
 const brands = await fetchBrands(client, { accountId });
 ```
+
+## Migration Guide: From Manual Client to Zero-Config
+
+### Before (Manual Setup)
+
+```typescript
+---
+import { generateServerClientUsingCookies } from "@htlkg/data/client";
+import { parseAmplifyConfig } from "aws-amplify/utils";
+import type { Schema } from "@backend/data/resource";
+import { amplifyOutputs } from "@/lib/amplify-config";
+
+const amplifyConfig = parseAmplifyConfig(amplifyOutputs);
+const client = generateServerClientUsingCookies<Schema>({
+  config: amplifyConfig,
+  cookies: Astro.cookies,
+  request: Astro.request,
+});
+
+const { data } = await client.models.User.list();
+---
+```
+
+### After (Zero-Config)
+
+```typescript
+---
+const { amplifyClient } = Astro.locals;
+
+const { data } = await amplifyClient.models.User.list();
+---
+```
+
+**Benefits:**
+- No imports needed for client setup
+- No config parsing
+- No manual parameter passing
+- Type-safe with full IntelliSense support
+- Client is automatically scoped to the authenticated user

package/dist/client/index.d.ts

@@ -1,57 +1,119 @@
 import { generateClient as generateClient$1 } from 'aws-amplify/data';
 import { ResourcesConfig } from 'aws-amplify';
-import { AstroGlobal } from 'astro';
-import { CommonPublicClientOptions, DefaultCommonClientOptions, V6ClientSSRCookies } from 'aws-amplify/api/internals';
+import { generateServerClientUsingCookies } from '../server/index.js';
+import 'astro';
+import 'aws-amplify/api/internals';
 
 /**
- * Server-side data client for Astro
+ * GraphQL Proxy Client
  *
- * Provides a client generator similar to Next.js's generateServerClientUsingCookies
- * using generateClientWithAmplifyInstance for proper server context integration.
+ * Client-side helper for making authenticated GraphQL operations through
+ * the server-side proxy. This allows Vue components to perform mutations
+ * while keeping auth cookies httpOnly for security.
+ *
+ * @module @htlkg/data/proxy
  */
-
-interface AstroCookiesClientParams {
-    cookies: AstroGlobal["cookies"];
-    request: AstroGlobal["request"];
-    config: ResourcesConfig;
+/**
+ * Valid GraphQL operations
+ */
+type Operation = "create" | "update" | "delete" | "get" | "list";
+/**
+ * Response type from GraphQL operations
+ */
+interface GraphQLResponse<T = any> {
+    data: T | null;
+    errors?: Array<{
+        message: string;
+        [key: string]: any;
+    }>;
 }
 /**
- * Generates a server-side data client for Astro (matches Next.js implementation)
+ * Options for proxy requests
+ */
+interface ProxyOptions {
+    /** Custom API endpoint (default: /api/graphql) */
+    endpoint?: string;
+    /** Additional fetch options */
+    fetchOptions?: RequestInit;
+}
+/**
+ * Execute a GraphQL mutation through the server proxy
  *
- * This function creates a client that automatically wraps all operations in the Amplify server context,
- * ensuring that authentication tokens from cookies are properly used.
+ * @param model - The model name (e.g., 'User', 'Brand', 'Account')
+ * @param operation - The operation type ('create', 'update', 'delete')
+ * @param data - The operation data/input
+ * @param options - Optional configuration
+ * @returns Promise with the operation result
  *
- * @example
+ * @example Create
  * ```typescript
- * import type { Schema } from '../amplify/data/resource';
- * import { generateServerClientUsingCookies } from '@htlkg/data/client';
- * import { parseAmplifyConfig } from 'aws-amplify/utils';
- * import outputs from '../amplify_outputs.json';
- *
- * const amplifyConfig = parseAmplifyConfig(outputs);
+ * const result = await mutate('User', 'create', {
+ *   email: 'user@example.com',
+ *   accountId: '123',
+ * });
+ * ```
  *
- * const client = generateServerClientUsingCookies<Schema>({
- *   config: amplifyConfig,
- *   cookies: Astro.cookies,
- *   request: Astro.request,
+ * @example Update
+ * ```typescript
+ * const result = await mutate('User', 'update', {
+ *   id: 'user-id',
+ *   status: 'deleted',
+ *   deletedAt: new Date().toISOString(),
  * });
+ * ```
+ *
+ * @example Delete
+ * ```typescript
+ * const result = await mutate('User', 'delete', { id: 'user-id' });
+ * ```
+ */
+declare function mutate<T = any>(model: string, operation: "create" | "update" | "delete", data: Record<string, any>, options?: ProxyOptions): Promise<GraphQLResponse<T>>;
+/**
+ * Execute a GraphQL query through the server proxy
+ *
+ * @param model - The model name (e.g., 'User', 'Brand', 'Account')
+ * @param operation - The operation type ('get', 'list')
+ * @param data - The query parameters (id for get, filter/limit for list)
+ * @param options - Optional configuration
+ * @returns Promise with the query result
  *
- * // Use the client directly - operations are automatically wrapped
- * const result = await client.models.User.list({
- *   selectionSet: ['id', 'email'],
+ * @example Get by ID
+ * ```typescript
+ * const result = await query('User', 'get', { id: 'user-id' });
+ * ```
+ *
+ * @example List with filter
+ * ```typescript
+ * const result = await query('User', 'list', {
+ *   filter: { status: { eq: 'active' } },
  *   limit: 100,
  * });
  * ```
  */
-declare function generateServerClientUsingCookies<T extends Record<any, any> = never, Options extends CommonPublicClientOptions & AstroCookiesClientParams = DefaultCommonClientOptions & AstroCookiesClientParams>(options: Options): V6ClientSSRCookies<T, Options>;
+declare function query<T = any>(model: string, operation: "get" | "list", data?: Record<string, any>, options?: ProxyOptions): Promise<GraphQLResponse<T>>;
+/**
+ * Helper to check if a response has errors
+ */
+declare function hasErrors(response: GraphQLResponse): boolean;
+/**
+ * Helper to get the first error message from a response
+ */
+declare function getErrorMessage(response: GraphQLResponse): string | null;
 
 /**
  * GraphQL Client for @htlkg/data
  *
  * Provides both client-side and server-side GraphQL capabilities using AWS Amplify Data.
  * The server-side functions use the Amplify Astro adapter for proper SSR support.
+ *
+ * For server-side usage, use `Astro.locals.amplifyClient` (zero-config, injected by middleware).
  */
 
+/**
+ * Type for the server-side Amplify client (for use in type declarations)
+ * This represents the client returned by generateServerClientUsingCookies
+ */
+type AmplifyServerClient<TSchema extends Record<string, unknown> = Record<string, unknown>> = ReturnType<typeof generateServerClientUsingCookies<TSchema>>;
 /**
  * Get or create the shared GraphQL client instance (singleton pattern)
  * Use this for client-side fetching to avoid creating multiple client instances.
@@ -151,6 +213,37 @@ interface GenerateServerClientOptions {
  * });
  * ```
  */
-declare function generateServerClient<TSchema extends Record<string, unknown> = Record<string, unknown>>(options?: GenerateServerClientOptions): ReturnType<typeof generateClient$1<TSchema>>;
+declare function generateServerClient<TSchema extends Record<string, unknown> = Record<string, unknown>>(_options?: GenerateServerClientOptions): ReturnType<typeof generateClient$1<TSchema>>;
+/**
+ * Context required for getting a server client in API routes
+ */
+interface ServerClientContext {
+    locals: {
+        amplifyClient?: any;
+        user?: any;
+    };
+    cookies: any;
+    request: Request;
+}
+/**
+ * Get the server client from Astro context
+ *
+ * Uses locals.amplifyClient if available (set by middleware),
+ * otherwise creates a new client using Amplify's global config.
+ * No config parameter needed - uses the config set by the middleware.
+ *
+ * @example
+ * ```typescript
+ * import { getServerClient } from '@htlkg/data/client';
+ *
+ * export const POST: APIRoute = async (context) => {
+ *   const client = getServerClient(context);
+ *   if (!client) return new Response('Not authenticated', { status: 401 });
+ *
+ *   const result = await client.models.User.list();
+ * };
+ * ```
+ */
+declare function getServerClient<TSchema extends Record<string, unknown> = Record<string, unknown>>(context: ServerClientContext): ReturnType<typeof generateServerClientUsingCookies<TSchema>> | null;
 
-export { type AstroAmplifyConfig, type GenerateServerClientOptions, type ServerAuthMode, generateClient, generateServerClient, generateServerClientUsingCookies, getSharedClient, resetSharedClient };
+export { type AmplifyServerClient, type AstroAmplifyConfig, type GenerateServerClientOptions, type GraphQLResponse, type Operation, type ProxyOptions, type ServerAuthMode, type ServerClientContext, generateClient, generateServerClient, generateServerClientUsingCookies, getErrorMessage, getServerClient, getSharedClient, hasErrors, mutate, query, resetSharedClient };

package/dist/client/index.js

@@ -1,5 +1,6 @@
 // src/client/index.ts
 import { generateClient as generateDataClient } from "aws-amplify/data";
+import { Amplify } from "aws-amplify";
 
 // src/client/server.ts
 import {
@@ -57,6 +58,54 @@ function generateServerClientUsingCookies(options) {
   });
 }
 
+// src/client/proxy.ts
+var DEFAULT_ENDPOINT = "/api/graphql";
+async function mutate(model, operation, data, options) {
+  return proxyRequest(model, operation, data, options);
+}
+async function query(model, operation, data, options) {
+  return proxyRequest(model, operation, data, options);
+}
+async function proxyRequest(model, operation, data, options) {
+  const endpoint = options?.endpoint ?? DEFAULT_ENDPOINT;
+  try {
+    const response = await fetch(endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      credentials: "include",
+      // Important: include cookies
+      ...options?.fetchOptions,
+      body: JSON.stringify({ model, operation, data })
+    });
+    const result = await response.json();
+    if (response.status === 401) {
+      console.error("[GraphQL Proxy] Unauthorized - session may have expired");
+    }
+    return result;
+  } catch (error) {
+    console.error("[GraphQL Proxy] Request failed:", error);
+    return {
+      data: null,
+      errors: [
+        {
+          message: error instanceof Error ? error.message : "Network error"
+        }
+      ]
+    };
+  }
+}
+function hasErrors(response) {
+  return !!response.errors && response.errors.length > 0;
+}
+function getErrorMessage(response) {
+  if (!response.errors || response.errors.length === 0) {
+    return null;
+  }
+  return response.errors[0].message;
+}
+
 // src/client/index.ts
 var sharedClientInstance = null;
 function getSharedClient() {
@@ -71,15 +120,40 @@ function resetSharedClient() {
 function generateClient() {
   return generateDataClient();
 }
-function generateServerClient(options) {
+function generateServerClient(_options) {
   const client = generateDataClient();
   return client;
 }
+function getServerClient(context) {
+  if (context.locals.amplifyClient) {
+    return context.locals.amplifyClient;
+  }
+  if (context.locals.user) {
+    try {
+      const amplifyConfig = Amplify.getConfig();
+      if (amplifyConfig) {
+        return generateServerClientUsingCookies({
+          config: amplifyConfig,
+          cookies: context.cookies,
+          request: context.request
+        });
+      }
+    } catch (e) {
+      console.error("[getServerClient] Failed to get Amplify config:", e);
+    }
+  }
+  return null;
+}
 export {
   generateClient,
   generateServerClient,
   generateServerClientUsingCookies,
+  getErrorMessage,
+  getServerClient,
   getSharedClient,
+  hasErrors,
+  mutate,
+  query,
   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// 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":[]}
+{"version":3,"sources":["../../src/client/index.ts","../../src/client/server.ts","../../src/client/proxy.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 * For server-side usage, use `Astro.locals.amplifyClient` (zero-config, injected by middleware).\n */\n\nimport { generateClient as generateDataClient } from \"aws-amplify/data\";\nimport { Amplify } from \"aws-amplify\";\nimport type { ResourcesConfig } from \"aws-amplify\";\nimport { generateServerClientUsingCookies } from \"./server\";\n\n// Re-export server-side client generation (used internally by middleware)\nexport { generateServerClientUsingCookies } from \"./server\";\n\n// Re-export proxy functions for authenticated client-side operations\nexport {\n\tmutate,\n\tquery,\n\thasErrors,\n\tgetErrorMessage,\n\ttype Operation,\n\ttype GraphQLResponse,\n\ttype ProxyOptions,\n} from \"./proxy\";\n\n/**\n * Type for the server-side Amplify client (for use in type declarations)\n * This represents the client returned by generateServerClientUsingCookies\n */\nexport type AmplifyServerClient<TSchema extends Record<string, unknown> = Record<string, unknown>> =\n\tReturnType<typeof generateServerClientUsingCookies<TSchema>>;\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\n\treturn client;\n}\n\n/**\n * Context required for getting a server client in API routes\n */\nexport interface ServerClientContext {\n\tlocals: { amplifyClient?: any; user?: any };\n\tcookies: any;\n\trequest: Request;\n}\n\n/**\n * Get the server client from Astro context\n *\n * Uses locals.amplifyClient if available (set by middleware),\n * otherwise creates a new client using Amplify's global config.\n * No config parameter needed - uses the config set by the middleware.\n *\n * @example\n * ```typescript\n * import { getServerClient } from '@htlkg/data/client';\n *\n * export const POST: APIRoute = async (context) => {\n *   const client = getServerClient(context);\n *   if (!client) return new Response('Not authenticated', { status: 401 });\n *\n *   const result = await client.models.User.list();\n * };\n * ```\n */\nexport function getServerClient<TSchema extends Record<string, unknown> = Record<string, unknown>>(\n\tcontext: ServerClientContext,\n): ReturnType<typeof generateServerClientUsingCookies<TSchema>> | null {\n\t// Try to use client from middleware first\n\tif (context.locals.amplifyClient) {\n\t\treturn context.locals.amplifyClient as ReturnType<typeof generateServerClientUsingCookies<TSchema>>;\n\t}\n\n\t// If no client from middleware and user is authenticated, create one using global Amplify config\n\tif (context.locals.user) {\n\t\ttry {\n\t\t\t// Get config from Amplify (set by middleware)\n\t\t\tconst amplifyConfig = Amplify.getConfig();\n\t\t\tif (amplifyConfig) {\n\t\t\t\treturn generateServerClientUsingCookies<TSchema>({\n\t\t\t\t\tconfig: amplifyConfig,\n\t\t\t\t\tcookies: context.cookies,\n\t\t\t\t\trequest: context.request,\n\t\t\t\t});\n\t\t\t}\n\t\t} catch (e) {\n\t\t\tconsole.error('[getServerClient] Failed to get Amplify config:', e);\n\t\t}\n\t}\n\n\t// No authentication available\n\treturn null;\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","/**\n * GraphQL Proxy Client\n *\n * Client-side helper for making authenticated GraphQL operations through\n * the server-side proxy. This allows Vue components to perform mutations\n * while keeping auth cookies httpOnly for security.\n *\n * @module @htlkg/data/proxy\n */\n\n/**\n * Valid GraphQL operations\n */\nexport type Operation = \"create\" | \"update\" | \"delete\" | \"get\" | \"list\";\n\n/**\n * Response type from GraphQL operations\n */\nexport interface GraphQLResponse<T = any> {\n\tdata: T | null;\n\terrors?: Array<{ message: string; [key: string]: any }>;\n}\n\n/**\n * Options for proxy requests\n */\nexport interface ProxyOptions {\n\t/** Custom API endpoint (default: /api/graphql) */\n\tendpoint?: string;\n\t/** Additional fetch options */\n\tfetchOptions?: RequestInit;\n}\n\n/**\n * Default proxy endpoint\n */\nconst DEFAULT_ENDPOINT = \"/api/graphql\";\n\n/**\n * Execute a GraphQL mutation through the server proxy\n *\n * @param model - The model name (e.g., 'User', 'Brand', 'Account')\n * @param operation - The operation type ('create', 'update', 'delete')\n * @param data - The operation data/input\n * @param options - Optional configuration\n * @returns Promise with the operation result\n *\n * @example Create\n * ```typescript\n * const result = await mutate('User', 'create', {\n *   email: 'user@example.com',\n *   accountId: '123',\n * });\n * ```\n *\n * @example Update\n * ```typescript\n * const result = await mutate('User', 'update', {\n *   id: 'user-id',\n *   status: 'deleted',\n *   deletedAt: new Date().toISOString(),\n * });\n * ```\n *\n * @example Delete\n * ```typescript\n * const result = await mutate('User', 'delete', { id: 'user-id' });\n * ```\n */\nexport async function mutate<T = any>(\n\tmodel: string,\n\toperation: \"create\" | \"update\" | \"delete\",\n\tdata: Record<string, any>,\n\toptions?: ProxyOptions,\n): Promise<GraphQLResponse<T>> {\n\treturn proxyRequest<T>(model, operation, data, options);\n}\n\n/**\n * Execute a GraphQL query through the server proxy\n *\n * @param model - The model name (e.g., 'User', 'Brand', 'Account')\n * @param operation - The operation type ('get', 'list')\n * @param data - The query parameters (id for get, filter/limit for list)\n * @param options - Optional configuration\n * @returns Promise with the query result\n *\n * @example Get by ID\n * ```typescript\n * const result = await query('User', 'get', { id: 'user-id' });\n * ```\n *\n * @example List with filter\n * ```typescript\n * const result = await query('User', 'list', {\n *   filter: { status: { eq: 'active' } },\n *   limit: 100,\n * });\n * ```\n */\nexport async function query<T = any>(\n\tmodel: string,\n\toperation: \"get\" | \"list\",\n\tdata?: Record<string, any>,\n\toptions?: ProxyOptions,\n): Promise<GraphQLResponse<T>> {\n\treturn proxyRequest<T>(model, operation, data, options);\n}\n\n/**\n * Internal function to make proxy requests\n */\nasync function proxyRequest<T>(\n\tmodel: string,\n\toperation: Operation,\n\tdata?: Record<string, any>,\n\toptions?: ProxyOptions,\n): Promise<GraphQLResponse<T>> {\n\tconst endpoint = options?.endpoint ?? DEFAULT_ENDPOINT;\n\n\ttry {\n\t\tconst response = await fetch(endpoint, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: {\n\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t},\n\t\t\tcredentials: \"include\", // Important: include cookies\n\t\t\t...options?.fetchOptions,\n\t\t\tbody: JSON.stringify({ model, operation, data }),\n\t\t});\n\n\t\tconst result: GraphQLResponse<T> = await response.json();\n\n\t\t// Handle auth errors\n\t\tif (response.status === 401) {\n\t\t\tconsole.error(\"[GraphQL Proxy] Unauthorized - session may have expired\");\n\t\t\t// Optionally trigger a redirect to login\n\t\t\t// window.location.href = '/login';\n\t\t}\n\n\t\treturn result;\n\t} catch (error) {\n\t\tconsole.error(\"[GraphQL Proxy] Request failed:\", error);\n\t\treturn {\n\t\t\tdata: null,\n\t\t\terrors: [\n\t\t\t\t{\n\t\t\t\t\tmessage: error instanceof Error ? error.message : \"Network error\",\n\t\t\t\t},\n\t\t\t],\n\t\t};\n\t}\n}\n\n/**\n * Helper to check if a response has errors\n */\nexport function hasErrors(response: GraphQLResponse): boolean {\n\treturn !!response.errors && response.errors.length > 0;\n}\n\n/**\n * Helper to get the first error message from a response\n */\nexport function getErrorMessage(response: GraphQLResponse): string | null {\n\tif (!response.errors || response.errors.length === 0) {\n\t\treturn null;\n\t}\n\treturn response.errors[0].message;\n}\n"],"mappings":"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","names":[]}

package/dist/hooks/index.d.ts

@@ -1,8 +1,10 @@
 import { Ref, ComputedRef } from 'vue';
-import { Brand, Account, User, Product } from '@htlkg/core/types';
+import { Brand, Account, User, Product, ProductInstance } from '@htlkg/core/types';
+import { C as CreateProductInstanceInput, U as UpdateProductInstanceInput } from '../productInstances-CzT3NZKU.js';
 export { resetSharedClient as resetClientInstance } from '../client/index.js';
 import 'aws-amplify/data';
 import 'aws-amplify';
+import '../server/index.js';
 import 'astro';
 import 'aws-amplify/api/internals';
 
@@ -305,4 +307,76 @@ interface UseProductsReturn {
  */
 declare function useProducts(options?: UseProductsOptions): UseProductsReturn;
 
-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 };
+/**
+ * useProductInstances Hook
+ *
+ * Vue composable for fetching and managing product instance data with reactive state.
+ * Provides loading states, error handling, refetch capabilities, and CRUD operations.
+ */
+
+interface UseProductInstancesOptions extends BaseHookOptions {
+    /** Filter criteria for product instances */
+    filter?: any;
+    /** Limit number of results */
+    limit?: number;
+    /** Auto-fetch on mount (default: true) */
+    autoFetch?: boolean;
+    /** Filter by brand ID */
+    brandId?: string;
+    /** Filter by account ID */
+    accountId?: string;
+    /** Filter by product ID */
+    productId?: string;
+    /** Only enabled instances */
+    enabledOnly?: boolean;
+}
+interface UseProductInstancesReturn {
+    /** Reactive array of product instances */
+    instances: Ref<ProductInstance[]>;
+    /** Computed array of enabled instances only */
+    enabledInstances: ComputedRef<ProductInstance[]>;
+    /** Loading state */
+    loading: Ref<boolean>;
+    /** Error state */
+    error: Ref<Error | null>;
+    /** Refetch product instances */
+    refetch: () => Promise<void>;
+    /** Create a new product instance */
+    createInstance: (input: CreateProductInstanceInput) => Promise<ProductInstance>;
+    /** Update an existing product instance */
+    updateInstance: (input: UpdateProductInstanceInput) => Promise<ProductInstance>;
+    /** Delete a product instance */
+    deleteInstance: (id: string) => Promise<boolean>;
+    /** Toggle the enabled status of a product instance */
+    toggleEnabled: (id: string, enabled: boolean) => Promise<ProductInstance>;
+}
+/**
+ * Composable for fetching and managing product instances
+ *
+ * @example
+ * ```typescript
+ * import { useProductInstances } from '@htlkg/data/hooks';
+ *
+ * const { instances, loading, error, refetch } = useProductInstances();
+ * ```
+ *
+ * @example With filters
+ * ```typescript
+ * const { instances, enabledInstances, loading } = useProductInstances({
+ *   brandId: 'brand-123',
+ *   enabledOnly: true,
+ *   limit: 50
+ * });
+ * ```
+ *
+ * @example For a specific account
+ * ```typescript
+ * const { instances, loading } = useProductInstances({
+ *   accountId: 'account-456',
+ *   autoFetch: true
+ * });
+ * ```
+ */
+declare function useProductInstances(options?: UseProductInstancesOptions): UseProductInstancesReturn;
+
+export { type BaseHookOptions, type CreateDataHookOptions, type DataHookReturn, type InferHookReturn, type UseAccountsOptions, type UseAccountsReturn, type UseBrandsOptions, type UseBrandsReturn, type UseProductInstancesOptions, type UseProductInstancesReturn, type UseProductsOptions, type UseProductsReturn, type UseUsersOptions, type UseUsersReturn, createDataHook, useAccounts, useBrands, useProductInstances, useProducts, useUsers };