@c15t/backend 0.0.1-rc.10

package/dist/utils/logger.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Represents the available log severity levels
+ *
+ * These levels determine the priority and visibility of log messages.
+ * The order from highest to lowest severity is typically:
+ * error > warn > info > success > debug
+ */
+export type LogLevel = 'info' | 'success' | 'warn' | 'error' | 'debug';
+/**
+ * Array of all available log levels in order of importance
+ *
+ * This const array ensures type safety when working with log levels
+ * and provides a reference for level comparisons.
+ */
+export declare const levels: readonly ["info", "success", "warn", "error", "debug"];
+/**
+ * Determines if a log message should be published based on configured log level
+ *
+ * @param currentLogLevel - The configured log level threshold for the logger
+ * @param logLevel - The level of the message being evaluated
+ * @returns Boolean indicating whether the message should be published
+ *
+ * @example
+ * ```ts
+ * // Only publish if error level is at or above the current log level
+ * if (shouldPublishLog('warn', 'error')) {
+ *   // This will return true as error is more severe than warn
+ * }
+ * ```
+ */
+export declare function shouldPublishLog(currentLogLevel: LogLevel, logLevel: LogLevel): boolean;
+/**
+ * Configuration interface for logger instances
+ *
+ * Provides options to customize logger behavior including
+ * disabling logs, setting log levels, and custom log handlers.
+ */
+export interface Logger {
+    /**
+     * Whether logging is disabled
+     *
+     * When true, no logs will be published regardless of log level
+     */
+    disabled?: boolean;
+    /**
+     * The minimum log level to publish
+     *
+     * Only logs with this level or higher severity will be published
+     * Note that 'success' is excluded as it's typically handled as 'info'
+     */
+    level?: Exclude<LogLevel, 'success'>;
+    /**
+     * Custom log handler function
+     *
+     * When provided, this function will be called instead of console methods
+     *
+     * @param level - The severity level of the log message
+     * @param message - The message to log
+     * @param args - Additional data to include in the log
+     */
+    log?: (level: Exclude<LogLevel, 'success'>, message: string, ...args: unknown[]) => void;
+}
+/**
+ * Type representing the parameters for log handlers
+ *
+ * This utility type extracts parameter types from the Logger.log function,
+ * excluding the first parameter (log level).
+ */
+export type LogHandlerParams = Parameters<NonNullable<Logger['log']>> extends [
+    LogLevel,
+    ...infer Rest
+] ? Rest : never;
+/**
+ * Creates a configured logger instance with methods for each log level
+ *
+ * @param options - Configuration options for the logger
+ * @returns An object with methods for each log level
+ *
+ * @example
+ * ```ts
+ * // Create a logger that only shows warnings and errors
+ * const logger = createLogger({ level: 'warn' });
+ *
+ * // These will be output
+ * logger.error('This is an error');
+ * logger.warn('This is a warning');
+ *
+ * // These will be suppressed
+ * logger.info('This info won\'t be shown');
+ * logger.debug('This debug message won\'t be shown');
+ * ```
+ */
+export declare const createLogger: (options?: Logger) => Record<LogLevel, (...params: LogHandlerParams) => void>;
+/**
+ * Default logger instance with standard configuration
+ *
+ * Ready-to-use logger with default settings (logs errors only)
+ *
+ * @example
+ * ```ts
+ * import { logger } from './logger';
+ *
+ * logger.error('Something went wrong');
+ * logger.info('This won\'t be shown with default settings');
+ * ```
+ */
+export declare const logger: Record<LogLevel, (message: string, ...args: unknown[]) => void>;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,MAAM,wDAAyD,CAAC;AAE7E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC/B,eAAe,EAAE,QAAQ,EACzB,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAET;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAErC;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,CACL,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,EACnC,OAAO,EAAE,MAAM,EACf,GAAG,IAAI,EAAE,OAAO,EAAE,KACd,IAAI,CAAC;CACV;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;IAC7E,QAAQ;IACR,GAAG,MAAM,IAAI;CACb,GACE,IAAI,GACJ,KAAK,CAAC;AAsET;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,GACxB,UAAU,MAAM,KACd,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAwDxD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,4DAvEkC,IAAI,CAuErB,CAAC"}

package/dist/utils/url.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Determines the base URL for API requests
+ *
+ * Attempts to derive a base URL from multiple sources in the following order:
+ * 1. The provided URL parameter
+ * 2. Various environment variables
+ * 3. Current window location (if in browser)
+ *
+ * @param url - Optional explicit URL to use
+ * @param path - Optional path to append to the URL if it doesn't have one
+ * @returns The determined base URL or undefined if unable to determine
+ *
+ * @throws {C15TError} When the provided URL is invalid
+ *
+ * @example
+ * ```ts
+ * // Get the base URL with default path ('/api/auth')
+ * const baseUrl = getBaseURL();
+ *
+ * // Get the base URL with custom path
+ * const apiUrl = getBaseURL(undefined, '/api/v2');
+ *
+ * // Use an explicit URL
+ * const customUrl = getBaseURL('https://example.com');
+ * ```
+ */
+export declare function getBaseURL(url?: string, path?: string): string | undefined;
+/**
+ * Extracts the origin component from a URL
+ *
+ * @param url - The URL to extract the origin from
+ * @returns The origin of the URL or null if invalid
+ *
+ * @example
+ * ```ts
+ * getOrigin('https://example.com/path'); // 'https://example.com'
+ * getOrigin('invalid-url'); // null
+ * ```
+ */
+export declare function getOrigin(url: string): string | null;
+/**
+ * Extracts the protocol component from a URL
+ *
+ * @param url - The URL to extract the protocol from
+ * @returns The protocol of the URL (including colon) or null if invalid
+ *
+ * @example
+ * ```ts
+ * getProtocol('https://example.com'); // 'https:'
+ * getProtocol('http://example.com'); // 'http:'
+ * getProtocol('invalid-url'); // null
+ * ```
+ */
+export declare function getProtocol(url: string): string | null;
+/**
+ * Checks if a string is a valid URL with a protocol
+ *
+ * Determines if the URL includes a protocol component (e.g., 'http://', 'https://'),
+ * which indicates it's a fully qualified URL rather than a relative path.
+ *
+ * @param url - The URL string to check
+ * @returns Boolean indicating whether the URL includes a protocol
+ *
+ * @example
+ * ```ts
+ * checkURLValidity('https://example.com'); // true
+ * checkURLValidity('example.com'); // false (no protocol)
+ * ```
+ */
+export declare const checkURLValidity: (url: string) => boolean;
+/**
+ * Extracts the host component from a URL
+ *
+ * If the URL is a fully qualified URL with a protocol, it parses the host correctly.
+ * If not, it assumes the entire string is the host.
+ *
+ * @param url - The URL to extract the host from
+ * @returns The host component of the URL
+ *
+ * @example
+ * ```ts
+ * getHost('https://example.com/path'); // 'example.com'
+ * getHost('example.com'); // 'example.com'
+ * ```
+ */
+export declare function getHost(url: string): string;
+//# sourceMappingURL=url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AA6DA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,sBAoBrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,iBAOpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,iBAOtC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,YAG3C,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,UAMlC"}

package/dist/utils/wildcard.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Transforms one or more glob patterns into a RegExp pattern
+ */
+declare function transform(pattern: string | string[], separator?: string | boolean): string;
+export default transform;
+interface WildcardMatchOptions {
+    /** Separator to be used to split patterns and samples into segments */
+    separator?: string | boolean;
+    /** Flags to pass to the RegExp */
+    flags?: string;
+}
+interface isMatch {
+    /**
+     * Tests if a sample string matches the pattern(s)
+     *
+     * ```js
+     * isMatch('foo') //=> true
+     * ```
+     */
+    (sample: string): boolean;
+    /** Compiled regular expression */
+    regexp: RegExp;
+    /** Original pattern or array of patterns that was used to compile the RegExp */
+    pattern: string | string[];
+    /** Options that were used to compile the RegExp */
+    options: WildcardMatchOptions;
+}
+declare function isMatch(regexp: RegExp, sample: string): boolean;
+/**
+ * Compiles one or more glob patterns into a RegExp and returns an isMatch function.
+ * The isMatch function takes a sample string as its only argument and returns `true`
+ * if the string matches the pattern(s).
+ *
+ * ```js
+ * wildcardMatch('src/*.js')('src/index.js') //=> true
+ * ```
+ *
+ * ```js
+ * const isMatch = wildcardMatch('*.example.com', '.')
+ * isMatch('foo.example.com') //=> true
+ * isMatch('foo.bar.com') //=> false
+ * ```
+ */
+declare function wildcardMatch(pattern: string | string[], options?: string | boolean | WildcardMatchOptions): isMatch;
+export { wildcardMatch, type isMatch };
+//# sourceMappingURL=wildcard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wildcard.d.ts","sourceRoot":"","sources":["../../src/utils/wildcard.ts"],"names":[],"mappings":"AAsCA;;GAEG;AACH,iBAAS,SAAS,CACjB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,SAAS,GAAE,MAAM,GAAG,OAAc,GAChC,MAAM,CAyGR;AAED,eAAe,SAAS,CAAC;AAEzB,UAAU,oBAAoB;IAC7B,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAID,UAAU,OAAO;IAChB;;;;;;OAMG;IACH,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1B,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IAEf,gFAAgF;IAChF,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE3B,mDAAmD;IACnD,OAAO,EAAE,oBAAoB,CAAC;CAC9B;AAED,iBAAS,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAM9C;AAED;;;;;;;;;;;;;;GAcG;AACH,iBAAS,aAAa,CACrB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,oBAAoB,WA0CjD;AAED,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,CAAC"}

package/knip.json

@@ -0,0 +1,37 @@
+{
+	"$schema": "https://unpkg.com/knip@latest/schema.json",
+	"entry": [
+		"./src/index.ts",
+		"./src/core.ts",
+		"./src/init.ts",
+		"./src/types/index.ts",
+		"./src/utils/index.ts",
+		"./src/client/index.ts",
+		"./src/db/adapters/prisma-adapter/index.ts",
+		"./src/db/adapters/drizzle-adapter/index.ts",
+		"./src/db/adapters/memory-adapter/index.ts",
+		"./src/error/index.ts",
+		"./src/error/codes.ts",
+		"./src/integrations/index.ts",
+		"./src/integrations/next.ts",
+		"./src/integrations/react.ts",
+		"./src/db/index.ts",
+		"./src/plugins/index.ts"
+	],
+	"project": "**/*.{js,ts,jsx,tsx}",
+	"ignoreDependencies": [
+		"typescript",
+		"@c15t/typescript-config",
+		"@better-fetch/fetch",
+		"drizzle-orm"
+	],
+	"ignoreBinaries": ["biome", "rslib"],
+	"ignore": ["**/*.spec.{js,ts}", "**/*.test.{js,ts}"],
+	"rules": {
+		"exports": "warn",
+		"types": "warn",
+		"dependencies": "error",
+		"files": "warn"
+	},
+	"ignoreExportsUsedInFile": true
+}

package/package.json

@@ -0,0 +1,146 @@
+{
+	"name": "@c15t/backend",
+	"version": "0.0.1-rc.10",
+	"license": "GPL-3.0-only",
+	"type": "module",
+  "publishConfig": {
+		"access": "public"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		},
+		"./types": {
+			"types": "./dist/types/index.d.ts",
+			"import": "./dist/types/index.js",
+			"require": "./dist/types/index.cjs"
+		},
+		"./utils": {
+			"types": "./dist/utils/index.d.ts",
+			"import": "./dist/utils/index.js",
+			"require": "./dist/utils/index.cjs"
+		},
+		"./client": {
+			"types": "./dist/client/index.d.ts",
+			"import": "./dist/client/index.js",
+			"require": "./dist/client/index.cjs"
+		},
+		"./db": {
+			"types": "./dist/db/index.d.ts",
+			"import": "./dist/db/index.js",
+			"require": "./dist/db/index.cjs"
+		},
+		"./db/migration": {
+			"types": "./dist/db/migration/index.d.ts",
+			"import": "./dist/db/migration/index.js",
+			"require": "./dist/db/migration/index.cjs"
+		},
+		"./db/adapters/prisma": {
+			"import": {
+				"types": "./dist/db/adapters/prisma-adapter/index.d.ts",
+				"import": "./dist/db/adapters/prisma.js"
+			},
+			"require": {
+				"types": "./dist/db/adapters/prisma-adapter/index.d.ts",
+				"default": "./dist/db/adapters/prisma.cjs"
+			}
+		},
+		"./db/adapters/drizzle": {
+			"import": {
+				"types": "./dist/db/adapters/drizzle-adapter/index.d.ts",
+				"import": "./dist/db/adapters/drizzle.js"
+			},
+			"require": {
+				"types": "./dist/db/adapters/drizzle-adapter/index.d.ts",
+				"default": "./dist/db/adapters/drizzle.cjs"
+			}
+		},
+		"./db/adapters/kysely": {
+			"import": {
+				"types": "./dist/db/adapters/kysely-adapter/index.d.ts",
+				"import": "./dist/db/adapters/kysely.js"
+			},
+			"require": {
+				"types": "./dist/db/adapters/kysely-adapter/index.d.ts",
+				"default": "./dist/db/adapters/kysely.cjs"
+			}
+		},
+		"./db/adapters/memory": {
+			"import": {
+				"types": "./dist/db/adapters/memory-adapter/index.d.ts",
+				"import": "./dist/db/adapters/memory.js"
+			},
+			"require": {
+				"types": "./dist/db/adapters/memory-adapter/index.d.ts",
+				"default": "./dist/db/adapters/memory.cjs"
+			}
+		},
+		"./plugins/geo": {
+			"types": "./dist/plugins/geo.d.ts",
+			"import": "./dist/plugins/geo.js",
+			"require": "./dist/plugins/geo.cjs"
+		},
+		"./error": {
+			"types": "./dist/error/index.d.ts",
+			"import": "./dist/error/index.js",
+			"require": "./dist/error/index.cjs"
+		},
+		"./error/codes": {
+			"types": "./dist/error/codes.d.ts",
+			"import": "./dist/error/codes.js",
+			"require": "./dist/error/codes.cjs"
+		},
+		"./package.json": "./package.json",
+		"./integrations": {
+			"types": "./dist/integrations/index.d.ts",
+			"import": "./dist/integrations/index.js",
+			"require": "./dist/integrations/index.cjs"
+		},
+		"./integrations/next": {
+			"types": "./dist/integrations/next.d.ts",
+			"import": "./dist/integrations/next.js",
+			"require": "./dist/integrations/next.cjs"
+		},
+		"./integrations/react": {
+			"types": "./dist/integrations/react.d.ts",
+			"import": "./dist/integrations/react.js",
+			"require": "./dist/integrations/react.cjs"
+		}
+	},
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"scripts": {
+		"build": "rslib build",
+		"check-types": "tsc --noEmit",
+		"dev": "rslib build --watch",
+		"fmt": "pnpm biome format --write . && biome check --formatter-enabled=false --linter-enabled=false --organize-imports-enabled=true --write",
+		"knip": "knip",
+		"lint": "pnpm biome lint ./src",
+		"test": "vitest"
+	},
+	"dependencies": {
+		"@better-fetch/fetch": "^1.1.15",
+		"base-x": "^5.0.1",
+		"better-call": "^1.0.4",
+		"better-sqlite3": "^11.8.1",
+		"defu": "^6.1.4",
+		"drizzle-orm": "^0.40.0",
+		"kysely": "^0.27.6",
+		"mysql2": "^3.13.0",
+		"neverthrow": "^8.2.0",
+		"pg": "^8.14.0",
+		"superjson": "^2.2.2",
+		"zod": "^3.24.2"
+	},
+	"devDependencies": {
+		"@c15t/typescript-config": "workspace:*",
+		"@types/better-sqlite3": "^7.6.12",
+		"@types/node": "^22.13.10",
+		"@types/pg": "^8.11.11",
+		"knip": "^5.45.0",
+		"typescript": "^5.8.2"
+	}
+}

package/rslib.config.ts

@@ -0,0 +1,104 @@
+import { defineConfig } from '@rslib/core';
+
+const externals = [
+	// Database packages
+	'prisma',
+	'@prisma/client',
+	'better-sqlite3',
+	'mongodb',
+	'drizzle-orm',
+	'bson',
+	'mongodb-connection-string-url',
+	'@mongodb-js/saslprep',
+	'kerberos',
+	'@mongodb-js/zstd',
+	'@aws-sdk/credential-providers',
+	'mongodb-client-encryption',
+
+	// UI frameworks
+	'react',
+	'vue',
+	'solid-js',
+	'solid-js/store',
+	'next/headers',
+	'$app/environment',
+	'@vue/runtime-dom',
+	'@vue/runtime-core',
+	'@vue/shared',
+	'@vue/reactivity',
+	'@vue/compiler-dom',
+	'@vue/compiler-core',
+	'csstype',
+
+	// Testing libraries
+	'vitest',
+	'@vitest/runner',
+	'@vitest/utils',
+	'@vitest/expect',
+	'@vitest/snapshot',
+	'@vitest/spy',
+	'chai',
+	'tinyspy',
+
+	// Utilities and others
+	'pathe',
+	'std-env',
+	'magic-string',
+	'pretty-format',
+	'p-limit',
+	'next/dist/compiled/@edge-runtime/cookies',
+	'@babel/types',
+	'@babel/parser',
+	'punycode',
+];
+
+export default defineConfig({
+	source: {
+		entry: {
+			index: ['./src/index.ts'],
+			'db/migration/index': ['./src/db/migration/index.ts'],
+			'types/index': ['./src/types/index.ts'],
+			'utils/index': ['./src/utils/index.ts'],
+			'client/index': ['./src/client/index.ts'],
+			'db/adapters/prisma': ['./src/db/adapters/prisma-adapter/index.ts'],
+			'db/adapters/drizzle': [
+				'./src/db/adapters/drizzle-adapter/drizzle-adapter.ts',
+			],
+			'db/adapters/memory': [
+				'./src/db/adapters/memory-adapter/memory-adapter.ts',
+			],
+			'db/adapters/kysely': [
+				'./src/db/adapters/kysely-adapter/kysely-adapter.ts',
+			],
+			'error/index': ['./src/error/index.ts'],
+			'error/codes': ['./src/error/codes.ts'],
+			'integrations/index': ['./src/integrations/index.ts'],
+			'integrations/next': ['./src/integrations/next.ts'],
+			'integrations/react': ['./src/integrations/react.ts'],
+			'db/index': ['./src/db/index.ts'],
+		},
+	},
+	lib: [
+		{
+			dts: true,
+			bundle: true,
+			format: 'esm',
+			output: {
+				externals,
+			},
+		},
+		{
+			dts: true,
+			bundle: true,
+			format: 'cjs',
+			output: {
+				externals,
+			},
+		},
+	],
+	output: {
+		target: 'node',
+		cleanDistPath: true,
+		externals,
+	},
+});