@superfunctions/db 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @superfunctions/db - Shared database adapter system
+ */
+export { createAdapterFactory } from './adapter/factory.js';
+export type { Adapter, TransactionAdapter, AdapterFactoryConfig, AdapterFactoryOptions, AdapterContext, HealthStatus, CreateParams, FindOneParams, FindManyParams, UpdateParams, DeleteParams, CreateManyParams, UpdateManyParams, DeleteManyParams, UpsertParams, CountParams, WhereClause, OrderBy, JoinConfig, TableSchema, FieldSchema, IndexSchema, ConstraintSchema, TableSchemaMap, ValidationResult, CreateSchemaParams, SchemaCreation, TransactionIsolation, LibraryOptions, Logger, AdapterImplementation, } from './adapter/types.js';
+export { DEFAULT_CAPABILITIES, mergeCapabilities } from './adapter/capabilities.js';
+export type { AdapterCapabilities } from './adapter/capabilities.js';
+export { AdapterError, AdapterErrorCode, ConnectionError, ConstraintViolationError, NotFoundError, DuplicateKeyError, QueryFailedError, TransactionError, SchemaValidationError, OperationNotSupportedError, } from './adapter/errors.js';
+export type { AdapterErrorOptions } from './adapter/errors.js';
+export { NamespaceManager, createDefaultNamespaceManager, createNamespaceManager, } from './utils/namespace.js';
+export type { NamespaceConfig } from './utils/namespace.js';
+export { SchemaTracker, createSchemaTracker } from './migrations/schema-tracker.js';
+export type { SchemaVersion } from './migrations/schema-tracker.js';
+export { validateRecordAgainstSchema } from './migrations/runtime-validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D,YAAY,EACV,OAAO,EACP,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,OAAO,EACP,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,MAAM,EACN,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACpF,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,EACL,gBAAgB,EAChB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACpF,YAAY,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @superfunctions/db - Shared database adapter system
+ */
+// Core factory
+export { createAdapterFactory } from './adapter/factory.js';
+// Capabilities
+export { DEFAULT_CAPABILITIES, mergeCapabilities } from './adapter/capabilities.js';
+// Errors
+export { AdapterError, AdapterErrorCode, ConnectionError, ConstraintViolationError, NotFoundError, DuplicateKeyError, QueryFailedError, TransactionError, SchemaValidationError, OperationNotSupportedError, } from './adapter/errors.js';
+// Utils
+export { NamespaceManager, createDefaultNamespaceManager, createNamespaceManager, } from './utils/namespace.js';
+// Schema Management
+export { SchemaTracker, createSchemaTracker } from './migrations/schema-tracker.js';
+export { validateRecordAgainstSchema } from './migrations/runtime-validation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAe;AACf,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAqC5D,eAAe;AACf,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGpF,SAAS;AACT,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAG7B,QAAQ;AACR,OAAO,EACL,gBAAgB,EAChB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAEpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/migrations/runtime-validation.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Simple runtime validation helpers for records against a TableSchema.
+ * These are intentionally lightweight and not a replacement for Zod/Valibot.
+ */
+import type { TableSchema, ValidationResult } from '../adapter/types.js';
+export declare function validateRecordAgainstSchema(schema: TableSchema, record: Record<string, unknown>): ValidationResult;
+//# sourceMappingURL=runtime-validation.d.ts.map

package/dist/migrations/runtime-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-validation.d.ts","sourceRoot":"","sources":["../../src/migrations/runtime-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAyBzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAQlH"}

package/dist/migrations/runtime-validation.js

@@ -0,0 +1,40 @@
+function validateField(fieldKey, field, value) {
+    if (value == null) {
+        if (field.required)
+            return `Field ${fieldKey} is required`;
+        return null;
+    }
+    switch (field.type) {
+        case 'string':
+            return typeof value === 'string' ? null : `Field ${fieldKey} must be a string`;
+        case 'number':
+            return typeof value === 'number' ? null : `Field ${fieldKey} must be a number`;
+        case 'boolean':
+            return typeof value === 'boolean' ? null : `Field ${fieldKey} must be a boolean`;
+        case 'date':
+            return value instanceof Date || typeof value === 'string' ? null : `Field ${fieldKey} must be a date or ISO string`;
+        case 'json':
+            try {
+                JSON.stringify(value);
+                return null;
+            }
+            catch {
+                return `Field ${fieldKey} must be JSON-serializable`;
+            }
+        case 'bigint':
+            return typeof value === 'bigint' || typeof value === 'number' ? null : `Field ${fieldKey} must be bigint or number`;
+        default:
+            return null;
+    }
+}
+export function validateRecordAgainstSchema(schema, record) {
+    const errors = [];
+    for (const [key, field] of Object.entries(schema.fields)) {
+        const v = record[key];
+        const err = validateField(key, field, v);
+        if (err)
+            errors.push(err);
+    }
+    return errors.length === 0 ? { valid: true } : { valid: false, errors };
+}
+//# sourceMappingURL=runtime-validation.js.map

package/dist/migrations/runtime-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-validation.js","sourceRoot":"","sources":["../../src/migrations/runtime-validation.ts"],"names":[],"mappings":"AAMA,SAAS,aAAa,CAAC,QAAgB,EAAE,KAAU,EAAE,KAAc;IACjE,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,KAAK,CAAC,QAAQ;YAAE,OAAO,SAAS,QAAQ,cAAc,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,QAAQ,mBAAmB,CAAC;QACjF,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,QAAQ,mBAAmB,CAAC;QACjF,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,QAAQ,oBAAoB,CAAC;QACnF,KAAK,MAAM;YACT,OAAO,KAAK,YAAY,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,QAAQ,+BAA+B,CAAC;QACtH,KAAK,MAAM;YACT,IAAI,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBAAC,OAAO,IAAI,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,SAAS,QAAQ,4BAA4B,CAAC;YAAC,CAAC;QAC7G,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,QAAQ,2BAA2B,CAAC;QACtH;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAAmB,EAAE,MAA+B;IAC9F,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,GAAI,MAAc,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACzC,IAAI,GAAG;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC1E,CAAC"}

package/dist/migrations/schema-tracker.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Schema version tracking for Superfunctions libraries
+ */
+import type { Adapter } from '../adapter/types.js';
+export interface SchemaVersion {
+    namespace: string;
+    version: number;
+    appliedAt: Date;
+}
+/**
+ * Schema tracker manages schema versions for libraries
+ */
+export declare class SchemaTracker {
+    private adapter;
+    private readonly TRACKING_TABLE;
+    constructor(adapter: Adapter);
+    /**
+     * Get current schema version for a library
+     */
+    getVersion(namespace: string): Promise<number>;
+    /**
+     * Set schema version for a library
+     */
+    setVersion(namespace: string, version: number): Promise<void>;
+    /**
+     * Get all schema versions
+     */
+    getAllVersions(): Promise<SchemaVersion[]>;
+    /**
+     * Initialize tracking table
+     * This should be called once during setup
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if a library's schema is up to date
+     */
+    isUpToDate(namespace: string, requiredVersion: number): Promise<boolean>;
+    /**
+     * Check if a library's schema needs migration
+     */
+    needsMigration(namespace: string, requiredVersion: number): Promise<boolean>;
+    /**
+     * Get version status for a library
+     */
+    getVersionStatus(namespace: string, requiredVersion: number): Promise<{
+        namespace: string;
+        current: number;
+        required: number;
+        status: 'up-to-date' | 'outdated' | 'not-installed' | 'newer';
+    }>;
+}
+/**
+ * Create a schema tracker instance
+ */
+export declare function createSchemaTracker(adapter: Adapter): SchemaTracker;
+//# sourceMappingURL=schema-tracker.d.ts.map

package/dist/migrations/schema-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-tracker.d.ts","sourceRoot":"","sources":["../../src/migrations/schema-tracker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;gBAEjD,OAAO,EAAE,OAAO;IAEpC;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAapD;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAYhD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK9E;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlF;;OAEG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,OAAO,CAAC;KAC/D,CAAC;CAqBH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAEnE"}

package/dist/migrations/schema-tracker.js

@@ -0,0 +1,121 @@
+/**
+ * Schema version tracking for Superfunctions libraries
+ */
+/**
+ * Schema tracker manages schema versions for libraries
+ */
+export class SchemaTracker {
+    adapter;
+    TRACKING_TABLE = '__superfunctions_schema_versions';
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    /**
+     * Get current schema version for a library
+     */
+    async getVersion(namespace) {
+        try {
+            const result = await this.adapter.findOne({
+                model: this.TRACKING_TABLE,
+                where: [{ field: 'namespace', operator: 'eq', value: namespace }],
+            });
+            return result?.version ?? 0;
+        }
+        catch {
+            // Table doesn't exist yet or other error
+            return 0;
+        }
+    }
+    /**
+     * Set schema version for a library
+     */
+    async setVersion(namespace, version) {
+        try {
+            await this.adapter.upsert({
+                model: this.TRACKING_TABLE,
+                where: [{ field: 'namespace', operator: 'eq', value: namespace }],
+                create: {
+                    namespace,
+                    version,
+                    appliedAt: new Date(),
+                },
+                update: {
+                    version,
+                    appliedAt: new Date(),
+                },
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to set schema version: ${error}`);
+        }
+    }
+    /**
+     * Get all schema versions
+     */
+    async getAllVersions() {
+        try {
+            return await this.adapter.findMany({
+                model: this.TRACKING_TABLE,
+                where: [],
+                orderBy: [{ field: 'namespace', direction: 'asc' }],
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Initialize tracking table
+     * This should be called once during setup
+     */
+    async initialize() {
+        // The tracking table needs to be created manually or via migrations
+        // This is a no-op for now, as table creation is ORM-specific
+    }
+    /**
+     * Check if a library's schema is up to date
+     */
+    async isUpToDate(namespace, requiredVersion) {
+        const currentVersion = await this.getVersion(namespace);
+        return currentVersion >= requiredVersion;
+    }
+    /**
+     * Check if a library's schema needs migration
+     */
+    async needsMigration(namespace, requiredVersion) {
+        const currentVersion = await this.getVersion(namespace);
+        return currentVersion < requiredVersion;
+    }
+    /**
+     * Get version status for a library
+     */
+    async getVersionStatus(namespace, requiredVersion) {
+        const current = await this.getVersion(namespace);
+        let status;
+        if (current === 0) {
+            status = 'not-installed';
+        }
+        else if (current < requiredVersion) {
+            status = 'outdated';
+        }
+        else if (current > requiredVersion) {
+            status = 'newer';
+        }
+        else {
+            status = 'up-to-date';
+        }
+        return {
+            namespace,
+            current,
+            required: requiredVersion,
+            status,
+        };
+    }
+}
+/**
+ * Create a schema tracker instance
+ */
+export function createSchemaTracker(adapter) {
+    return new SchemaTracker(adapter);
+}
+//# sourceMappingURL=schema-tracker.js.map

package/dist/migrations/schema-tracker.js.map

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

package/dist/testing/contract-tests.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Contract tests for adapter compliance
+ */
+import type { Adapter, TableSchemaMap } from '../adapter/types.js';
+export interface AdapterTestConfig {
+    adapter: Adapter;
+    namespace: string;
+    testSchema: TableSchemaMap;
+    capabilities?: string[];
+    beforeEach?: () => Promise<void>;
+    afterEach?: () => Promise<void>;
+}
+/**
+ * Test adapter contract compliance
+ * Use with your test framework (vitest, jest, etc.)
+ */
+export declare function testAdapterContract(config: AdapterTestConfig): {
+    /**
+     * Test CRUD operations
+     */
+    testCRUD(): Promise<{
+        name: string;
+        test: () => Promise<void>;
+    }[]>;
+    /**
+     * Test batch operations
+     */
+    testBatch(): Promise<{
+        name: string;
+        test: () => Promise<void>;
+    }[]>;
+    /**
+     * Test advanced operations
+     */
+    testAdvanced(): Promise<{
+        name: string;
+        test: () => Promise<void>;
+    }[]>;
+    /**
+     * Test lifecycle operations
+     */
+    testLifecycle(): Promise<{
+        name: string;
+        test: () => Promise<void>;
+    }[]>;
+    /**
+     * Run all contract tests
+     */
+    runAll(): Promise<{
+        total: number;
+        passed: number;
+        failed: number;
+        errors: Array<{
+            name: string;
+            error: Error;
+        }>;
+    }>;
+};
+/**
+ * Helper function to run contract tests with a test framework
+ * Pass your test framework's describe, it, beforeEach, afterEach functions
+ */
+export declare function describeAdapterContract(name: string, config: AdapterTestConfig, describe: any, it: any, beforeEach?: any, afterEach?: any): void;
+//# sourceMappingURL=contract-tests.d.ts.map

package/dist/testing/contract-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-tests.d.ts","sourceRoot":"","sources":["../../src/testing/contract-tests.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,cAAc,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB;IAIzD;;OAEG;;cAE0B,MAAM;cAAQ,MAAM,OAAO,CAAC,IAAI,CAAC;;IAsI9D;;OAEG;;cAM0B,MAAM;cAAQ,MAAM,OAAO,CAAC,IAAI,CAAC;;IA4B9D;;OAEG;;cAE0B,MAAM;cAAQ,MAAM,OAAO,CAAC,IAAI,CAAC;;IAmE9D;;OAEG;;cAE0B,MAAM;cAAQ,MAAM,OAAO,CAAC,IAAI,CAAC;;IAiC9D;;OAEG;;;;;gBAae,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,KAAK,CAAA;SAAE,CAAC;;EA2B1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,GAAG,EACb,EAAE,EAAE,GAAG,EACP,UAAU,CAAC,EAAE,GAAG,EAChB,SAAS,CAAC,EAAE,GAAG,QAuGhB"}