@c15t/backend 0.0.1-rc.10

package/dist/integrations/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/integrations/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;;;;;GAOG;AACH,KAAK,SAAS,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;AAE5B;;;;GAIG;AACH,UAAU,YAAY;IACrB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAE7B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE5C;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;GAKG;AACH,UAAU,cAAc;IACvB;;;;;OAKG;IACH,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;;OAKG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;;;OAKG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;OAIG;IACH,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,KAAK,YAAY,GAAG,YAAY,GAAG,cAAc,CAAC;AAElD;;GAEG;AACH,UAAU,gBAAgB;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAAC,EAAE;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;KACnC,CAAC;CACF;AAED;;;;;;GAMG;AACH,UAAU,QAAQ,CAAC,CAAC;IACnB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC,CAAC;IAElB;;;OAGG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAErE;;;;OAIG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACxD;AAED;;GAEG;AACH,UAAU,wBAAwB;IACjC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5C;AAED;;GAEG;AACH,UAAU,aAAa;IACtB;;OAEG;IACH,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE9B;;OAEG;IACH,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IAEpC;;OAEG;IACH,qBAAqB,EAAE,CACtB,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,KAC9B,wBAAwB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,GAAE,gBAAqB,GAC3B,aAAa,CA0Rf"}

package/dist/integrations/react.js

@@ -0,0 +1,150 @@
+function createConsentClient(config = {}) {
+    const { baseUrl = '/api/c15t', refreshInterval = 0, defaultPreferences = {
+        analytics: true,
+        marketing: true,
+        preferences: true
+    } } = config;
+    function createStore(createState) {
+        let state;
+        const listeners = new Set();
+        const setState = (partial)=>{
+            const nextState = 'function' == typeof partial ? {
+                ...state,
+                ...partial(state)
+            } : {
+                ...state,
+                ...partial
+            };
+            state = nextState;
+            for (const listener of listeners)listener(state);
+        };
+        const getState = ()=>state;
+        const subscribe = (listener)=>{
+            listeners.add(listener);
+            return ()=>listeners.delete(listener);
+        };
+        state = createState(setState, getState);
+        return {
+            getState,
+            setState,
+            subscribe
+        };
+    }
+    const consentStore = createStore((set, get)=>({
+            isLoading: true,
+            hasConsented: null,
+            preferences: null,
+            error: null,
+            lastUpdated: null,
+            setConsent: async (preferences)=>{
+                try {
+                    set({
+                        isLoading: true,
+                        error: null
+                    });
+                    const response = await fetch(`${baseUrl}/set`, {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/json'
+                        },
+                        body: JSON.stringify({
+                            preferences
+                        }),
+                        credentials: 'same-origin'
+                    });
+                    if (!response.ok) throw new Error(`Failed to set consent: ${response.statusText}`);
+                    const result = await response.json();
+                    set({
+                        isLoading: false,
+                        hasConsented: true,
+                        preferences: result.preferences || preferences,
+                        lastUpdated: Date.now()
+                    });
+                    return result;
+                } catch (error) {
+                    set({
+                        isLoading: false,
+                        error: error instanceof Error ? error : new Error(String(error))
+                    });
+                    throw error;
+                }
+            },
+            acceptAll: async ()=>{
+                const cleanPreferences = Object.entries(defaultPreferences).filter(([_, value])=>void 0 !== value).reduce((acc, [key, value])=>{
+                    acc[key] = value;
+                    return acc;
+                }, {});
+                return await get().setConsent(cleanPreferences);
+            },
+            declineAll: async ()=>{
+                const minimalConsent = Object.keys(defaultPreferences).reduce((acc, key)=>{
+                    acc[key] = false;
+                    return acc;
+                }, {});
+                return await get().setConsent(minimalConsent);
+            },
+            refreshStatus: async ()=>{
+                try {
+                    set({
+                        isLoading: true,
+                        error: null
+                    });
+                    const response = await fetch(`${baseUrl}/status`, {
+                        credentials: 'same-origin'
+                    });
+                    if (!response.ok) throw new Error(`Failed to get consent status: ${response.statusText}`);
+                    const { consented, preferences } = await response.json();
+                    set({
+                        isLoading: false,
+                        hasConsented: consented,
+                        preferences: preferences,
+                        lastUpdated: Date.now()
+                    });
+                } catch (error) {
+                    set({
+                        isLoading: false,
+                        error: error instanceof Error ? error : new Error(String(error))
+                    });
+                }
+            },
+            clearError: ()=>{
+                set({
+                    error: null
+                });
+            }
+        }));
+    const useConsent = ()=>{
+        const storeState = consentStore.getState();
+        if ('undefined' == typeof window) return storeState;
+        setTimeout(()=>{
+            if (null === storeState.hasConsented && !storeState.isLoading) storeState.refreshStatus();
+            if (refreshInterval > 0) {
+                const intervalId = setInterval(()=>{
+                    storeState.refreshStatus();
+                }, refreshInterval);
+                window.addEventListener('unload', ()=>clearInterval(intervalId));
+            }
+        }, 0);
+        return storeState;
+    };
+    const useConditionalContent = (requiredConsent)=>{
+        const store = useConsent();
+        const canShow = ()=>{
+            if (store.isLoading || !store.hasConsented || !store.preferences) return false;
+            if (Array.isArray(requiredConsent)) return requiredConsent.every((key)=>store.preferences?.[key]);
+            return !!store.preferences[requiredConsent];
+        };
+        return {
+            isLoading: store.isLoading,
+            hasConsented: store.hasConsented,
+            canShow: canShow(),
+            preferences: store.preferences
+        };
+    };
+    return {
+        store: consentStore,
+        useConsent,
+        useConditionalContent
+    };
+}
+export { createConsentClient };

package/dist/plugins/geo/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/geo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/geo/index.ts"],"names":[],"mappings":""}

package/dist/test/utils.d.ts

@@ -0,0 +1,65 @@
+import type { C15TContext } from '../types';
+/**
+ * Creates a mock context for testing API endpoints
+ *
+ * @returns A mock C15TContext with default values
+ */
+export declare function createMockContext(): C15TContext;
+/**
+ * Creates a mock request for testing
+ *
+ * @param url - The request URL
+ * @param method - The HTTP method
+ * @param body - Optional request body
+ * @returns A mock Request object
+ */
+export declare function createMockRequest(url: string, method?: string, body?: unknown): Request;
+/**
+ * Creates a mock response for testing
+ *
+ * @param status - The HTTP status code
+ * @param body - The response body
+ * @returns A mock Response object
+ */
+export declare function createMockResponse(status: number, body: unknown): Response;
+/**
+ * Helper to create a mock consent object
+ *
+ * @param overrides - Optional overrides for the default consent object
+ * @returns A mock consent object
+ */
+export declare function createMockConsent(overrides?: Partial<{
+    subjectId: string;
+    domain: string;
+    preferences: Record<string, string>;
+    status: string;
+    givenAt: string;
+}>): {
+    subjectId: string;
+    domain: string;
+    preferences: Record<string, string>;
+    status: string;
+    givenAt: string;
+};
+/**
+ * Helper to create a mock consent policy
+ *
+ * @param overrides - Optional overrides for the default policy object
+ * @returns A mock consent policy object
+ */
+export declare function createMockPolicy(overrides?: Partial<{
+    id: string;
+    domain: string;
+    version: string;
+    content: string;
+    availablePreferences: Record<string, string[]>;
+    createdAt: string;
+}>): {
+    id: string;
+    domain: string;
+    version: string;
+    content: string;
+    availablePreferences: Record<string, string[]>;
+    createdAt: string;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/test/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/test/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAyI/C;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,SAAQ,EACd,IAAI,CAAC,EAAE,OAAO,GACZ,OAAO,CAQT;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAO1E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,SAAS,GAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB,CAAM;eALK,MAAM;YACT,MAAM;iBACD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;YAC3B,MAAM;aACL,MAAM;EAehB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,SAAS,GAAE,OAAO,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/C,SAAS,EAAE,MAAM,CAAC;CAClB,CAAM;QANF,MAAM;YACF,MAAM;aACL,MAAM;aACN,MAAM;0BACO,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;eACnC,MAAM;EAgBlB"}

package/dist/types/api.d.ts

@@ -0,0 +1,89 @@
+/**
+ * API Types for c15t
+ *
+ * Definitions for API routes, request handlers, and endpoint configuration
+ */
+import type { Endpoint } from 'better-call';
+/**
+ * Filter action methods from an object type
+ *
+ * This type utility extracts only the method properties from an object type,
+ * useful for API type inference.
+ *
+ * @typeParam TObject - The object type to filter action methods from
+ *
+ * @example
+ * ```ts
+ * interface APIHandlers {
+ *   getSubject: (id: string) => Promise<Subject>;
+ *   userData: Subject;
+ *   updateSubject: (subject: Subject) => Promise<void>;
+ * }
+ *
+ * // ActionKeys will be 'getSubject' | 'updateSubject'
+ * type ActionKeys = FilterActions<APIHandlers>[keyof FilterActions<APIHandlers>];
+ * ```
+ */
+export type FilterActions<TObject extends Record<string, unknown>> = {
+    [Key in keyof TObject]: TObject[Key] extends (...args: unknown[]) => unknown ? Key : never;
+};
+/**
+ * Base API path template literal for c15t endpoints
+ *
+ * This type defines the base path for all API routes in the c15t system.
+ * Used as a foundation for building type-safe API route paths.
+ *
+ * @see ApiPath for complete path patterns
+ */
+export type ApiPathBase = `/api/c15t`;
+/**
+ * API route path with strict type checking
+ *
+ * This type union represents all valid API paths in the system.
+ * It enforces type safety when defining routes or middlewares to
+ * prevent typos and ensure consistency.
+ *
+ * @example
+ * ```ts
+ * // Valid API path
+ * const consentPath: ApiPath = '/api/c15t/consent';
+ *
+ * // Invalid - would cause a type error
+ * const invalidPath: ApiPath = '/api/c15t/unknown-endpoint';
+ * ```
+ */
+export type ApiPath = `${ApiPathBase}` | `${ApiPathBase}/consent` | `${ApiPathBase}/consent/:id` | `${ApiPathBase}/jurisdictions` | `${ApiPathBase}/jurisdictions/:code` | `${ApiPathBase}/plugins/:id`;
+/**
+ * Strongly-typed middleware configuration
+ *
+ * Defines the structure for API middleware registrations,
+ * ensuring that both the path and middleware function are properly typed.
+ *
+ * @see ApiPath for valid path patterns
+ *
+ * @example
+ * ```ts
+ * // Register a middleware for the consent endpoint
+ * const authMiddleware: ApiMiddleware = {
+ *   path: '/api/c15t/consent',
+ *   middleware: async (ctx, next) => {
+ *     // Verify authentication
+ *     if (!ctx.request.headers.get('Authorization')) {
+ *       return ctx.json({ error: 'Unauthorized' }, { status: 401 });
+ *     }
+ *     return next();
+ *   }
+ * };
+ * ```
+ */
+export interface ApiMiddleware {
+    /**
+     * The API path to apply this middleware to
+     */
+    path: ApiPath;
+    /**
+     * The middleware function to execute
+     */
+    middleware: Endpoint;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KACnE,GAAG,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACzE,GAAG,GACH,KAAK;CACR,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,OAAO,GAChB,GAAG,WAAW,EAAE,GAChB,GAAG,WAAW,UAAU,GACxB,GAAG,WAAW,cAAc,GAC5B,GAAG,WAAW,gBAAgB,GAC9B,GAAG,WAAW,sBAAsB,GACpC,GAAG,WAAW,cAAc,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,QAAQ,CAAC;CACrB"}

package/dist/types/context.d.ts

@@ -0,0 +1,205 @@
+import type { EndpointContext, EndpointOptions, InputContext } from 'better-call';
+import type { getConsentTables } from '../db';
+import type { Adapter } from '../db/adapters/types';
+import type { EntityName } from '../db/core/types';
+import type { createRegistry } from '../db/create-registry';
+import type { DatabaseHook } from '../db/hooks/types';
+import type { createLogger } from '../utils';
+import type { C15TOptions } from './index';
+/**
+ * Extended endpoint context for hooks
+ *
+ * This type extends the standard endpoint context with additional properties
+ * specific to c15t hooks, allowing hooks to access the complete c15t context.
+ *
+ * @typeParam TOptions - Endpoint configuration options type
+ *
+ * @see GenericEndpointContext for a simpler context type without input context inclusion
+ */
+export type HookEndpointContext<TOptions extends EndpointOptions = EndpointOptions> = EndpointContext<string, TOptions> & Omit<InputContext<string, TOptions>, 'method'> & {
+    /**
+     * The c15t context with possible hook-specific extensions
+     */
+    context: C15TContext & {
+        /**
+         * Value returned by the endpoint handler, available in 'after' hooks
+         */
+        returned?: unknown;
+        /**
+         * Response headers, available in 'after' hooks
+         */
+        responseHeaders?: Headers;
+    };
+    /**
+     * Request headers
+     */
+    headers?: Headers;
+};
+/**
+ * Standard endpoint context for c15t handlers
+ *
+ * A simplified context type that includes the c15t context,
+ * used by endpoint handlers throughout the system.
+ *
+ * @typeParam TOptions - Endpoint configuration options type
+ */
+export type GenericEndpointContext<TOptions extends EndpointOptions = EndpointOptions> = EndpointContext<string, TOptions> & {
+    /**
+     * The c15t application context
+     */
+    context: C15TContext;
+};
+/**
+ * Base shared context for all c15t components
+ *
+ * Contains the minimal set of properties needed by all components
+ * in the c15t system, including configuration options and logging.
+ */
+export interface BaseContext {
+    /**
+     * Configuration options for the c15t system
+     */
+    options: C15TOptions;
+    /**
+     * Logger instance for recording events and errors
+     */
+    logger: ReturnType<typeof createLogger>;
+}
+/**
+ * Registry-specific context for database adapters
+ *
+ * Extends the base context with properties needed for
+ * database operations and entity management.
+ */
+export interface RegistryContext extends BaseContext {
+    /**
+     * Database adapter instance
+     */
+    adapter: Adapter;
+    /**
+     * Database lifecycle hooks
+     */
+    hooks: DatabaseHook[];
+    /**
+     * Function to generate unique IDs for entities
+     *
+     * @param options - Options for ID generation including entity type and length
+     * @returns A unique ID string
+     */
+    generateId: (options: {
+        model: EntityName;
+        size?: number;
+    }) => string;
+}
+/**
+ * Base context without plugin-specific extensions
+ *
+ * This interface defines the core context properties available to all
+ * components in the c15t system before plugin extensions are applied.
+ */
+export interface BaseC15TContext {
+    /**
+     * Application name displayed in consent dialogs
+     */
+    appName: string;
+    /**
+     * Configuration options for the c15t system
+     */
+    options: C15TOptions;
+    /**
+     * List of origins that are trusted for CORS and CSRF protection
+     */
+    trustedOrigins: string[];
+    /**
+     * Base URL for API requests
+     */
+    baseURL: string;
+    /**
+     * Secret key used for signing cookies and tokens
+     */
+    secret: string;
+    /**
+     * Logger instance for recording events and errors
+     */
+    logger: ReturnType<typeof createLogger>;
+    /**
+     * Function to generate unique IDs for entities
+     *
+     * @param options - Options for ID generation including entity type and length
+     * @returns A unique ID string
+     */
+    generateId: (options: {
+        model: EntityName;
+        size?: number;
+    }) => string;
+    /**
+     * Database adapter instance
+     */
+    adapter: Adapter;
+    /**
+     * Entity registry for database operations
+     */
+    registry: ReturnType<typeof createRegistry>;
+    /**
+     * Database tables for the consent system
+     */
+    tables: ReturnType<typeof getConsentTables>;
+    /**
+     * IP address of the client
+     */
+    ipAddress?: string | null;
+    /**
+     * Subject agent of the client
+     */
+    userAgent?: string | null;
+}
+/**
+ * Extended context type with plugin extensions
+ *
+ * This type extends the base context with plugin-specific properties,
+ * allowing plugins to add their own functionality to the context.
+ *
+ * @typeParam TPluginContext - Record of plugin-specific context extensions
+ *
+ * @example
+ * ```ts
+ * // Plugin extending the context with analytics capabilities
+ * interface AnalyticsContext {
+ *   analytics: {
+ *     trackEvent: (event: string, data: unknown) => void;
+ *     getSessionId: () => string;
+ *   }
+ * }
+ *
+ * // Using the extended context in a component
+ * function handleConsent(ctx: C15TContext<AnalyticsContext>) {
+ *   // Base context is available
+ *   const { baseURL, logger } = ctx;
+ *
+ *   // Plugin context is also available
+ *   ctx.analytics.trackEvent('consent_given', { timestamp: Date.now() });
+ * }
+ * ```
+ */
+export type C15TContext<TPluginContext extends Record<string, unknown> = Record<string, unknown>> = BaseC15TContext & TPluginContext;
+/**
+ * Helper to extract context with a specific plugin's context type
+ *
+ * This utility type makes it easier to work with context that has been
+ * extended by a specific plugin, providing proper type information.
+ *
+ * @typeParam TPluginName - The name of the plugin providing the context extension
+ * @typeParam TPluginContext - The type of the context extension provided by the plugin
+ *
+ * @example
+ * ```ts
+ * // Working with a specific plugin's context
+ * function useGeoPlugin(ctx: ContextWithPlugin<'geo', GeoPluginContext>) {
+ *   // TypeScript knows that ctx.geo exists and has the right type
+ *   const country = ctx.geo.getCurrentCountry();
+ *   return country;
+ * }
+ * ```
+ */
+export type ContextWithPlugin<TPluginName extends string, TPluginContext extends Record<string, unknown>> = C15TContext<Record<TPluginName, TPluginContext>>;
+//# sourceMappingURL=context.d.ts.map

package/dist/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"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"}

package/dist/types/helper.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Represents a string literal type
+ *
+ * This type ensures that only string literals are accepted, not general string types.
+ * It's useful for ensuring type safety with specific string values.
+ *
+ * @example
+ * ```ts
+ * // Function that only accepts literal strings, not string variables
+ * function doSomething(value: LiteralString) {
+ *   // Implementation
+ * }
+ *
+ * // Valid usage:
+ * doSomething('specific-value');
+ *
+ * // Invalid usage:
+ * const dynamicString = getStringFromSomewhere();
+ * doSomething(dynamicString); // Type error
+ * ```
+ */
+export type LiteralString = '' | (string & Record<never, never>);
+/**
+ * Extracts all required keys from an object type
+ *
+ * This utility type identifies which keys in an object type are required
+ * (not optional or undefined). Useful for type manipulation in complex types.
+ *
+ * @typeParam BaseType - The object type to extract required keys from
+ *
+ * @example
+ * ```ts
+ * interface Subject {
+ *   id: number;
+ *   name: string;
+ *   email?: string;
+ * }
+ *
+ * // RequiredKeysOf<Subject> will be 'id' | 'name'
+ * type RequiredsubjectFields = RequiredKeysOf<Subject>;
+ * ```
+ */
+export type RequiredKeysOf<BaseType extends object> = Exclude<{
+    [Key in keyof BaseType]: BaseType extends Record<Key, BaseType[Key]> ? Key : never;
+}[keyof BaseType], undefined>;
+/**
+ * Makes all properties in an object type optional recursively
+ *
+ * Unlike TypeScript's built-in Partial<T>, this type makes nested object
+ * properties optional as well. Functions are preserved as-is.
+ *
+ * @typeParam T - The type to make deeply partial
+ */
+export type DeepPartial<T> = T extends (...args: unknown[]) => unknown ? T : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/**
+ * Recursively expands object types for better IntelliSense
+ *
+ * This utility improves type display in editors by expanding nested type
+ * definitions. Particularly useful when working with complex types
+ * created through composition or manipulation.
+ *
+ * @typeParam T - The type to expand recursively
+ *
+ * @example
+ * ```ts
+ * // Before expansion: Intersection of multiple types
+ * type ComplexType = TypeA & TypeB & { extraProp: string };
+ *
+ * // After expansion: Flat object type with all properties visible
+ * type ExpandedType = ExpandRecursively<ComplexType>;
+ * ```
+ */
+export type ExpandRecursively<T> = T extends infer O ? {
+    [K in keyof O]: O[K];
+} : never;
+//# sourceMappingURL=helper.d.ts.map

package/dist/types/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../src/types/helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,aAAa,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,cAAc,CAAC,QAAQ,SAAS,MAAM,IAAI,OAAO,CAC5D;KACE,GAAG,IAAI,MAAM,QAAQ,GAAG,QAAQ,SAAS,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,GACjE,GAAG,GACH,KAAK;CACR,CAAC,MAAM,QAAQ,CAAC,EACjB,SAAS,CACT,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACnE,CAAC,GACD,CAAC,SAAS,MAAM,GACf;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACtC,CAAC,CAAC;AAEN;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,GACjD;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GACxB,KAAK,CAAC"}

package/dist/types/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.r = function(exports1) {
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+var __webpack_export_target__ = exports;
+for(var __webpack_i__ in __webpack_exports__)__webpack_export_target__[__webpack_i__] = __webpack_exports__[__webpack_i__];
+if (__webpack_exports__.__esModule) Object.defineProperty(__webpack_export_target__, '__esModule', {
+    value: true
+});

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export type * from './api';
+export type * from './context';
+export type * from './helper';
+export type * from './options';
+export type * from './plugins';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,OAAO,CAAC;AAC3B,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,UAAU,CAAC;AAC9B,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,WAAW,CAAC"}