fix: advanced-alchemy skills

Author: Harshal6927

plugins/litestar/skills/advanced-alchemy/references/fastapi-integration.md

@@ -118,14 +118,21 @@ from uuid import UUID
 
 from fastapi import APIRouter, Depends
 from pydantic import BaseModel
-from sqlalchemy.orm import Mapped, mapped_column
+from sqlalchemy import ForeignKey
+from sqlalchemy.orm import Mapped, mapped_column, relationship
 
-from advanced_alchemy.base import UUIDBase
+from advanced_alchemy.base import UUIDAuditBase
 from advanced_alchemy.repository import SQLAlchemyAsyncRepository
 from advanced_alchemy.service import SQLAlchemyAsyncRepositoryService
 
-class OrderModel(UUIDBase):
+class CustomerModel(UUIDAuditBase):
+    __tablename__ = "customer"
+    name: Mapped[str] = mapped_column()
+
+class OrderModel(UUIDAuditBase):
     __tablename__ = "order"
+    customer_id: Mapped[UUID] = mapped_column(ForeignKey("customer.id"))
+    customer: Mapped[CustomerModel] = relationship()
     customer_email: Mapped[str] = mapped_column()
     total_cents: Mapped[int] = mapped_column()
 
@@ -288,7 +295,7 @@ from pydantic import BaseModel
 from sqlalchemy.orm import Mapped, mapped_column
 
 from advanced_alchemy import filters
-from advanced_alchemy.base import UUIDBase
+from advanced_alchemy.base import UUIDAuditBase
 from advanced_alchemy.repository import SQLAlchemyAsyncRepository
 from advanced_alchemy.service import OffsetPagination, SQLAlchemyAsyncRepositoryService
 from advanced_alchemy.extensions.fastapi import (
@@ -298,7 +305,7 @@ from advanced_alchemy.extensions.fastapi import (
     assign_cli_group,
 )
 
-class OrderModel(UUIDBase):
+class OrderModel(UUIDAuditBase):
     __tablename__ = "order"
     customer_email: Mapped[str] = mapped_column()
     total_cents: Mapped[int] = mapped_column()

plugins/litestar/skills/advanced-alchemy/references/operations.md

@@ -15,7 +15,8 @@ from advanced_alchemy.operations import OnConflictUpsert
 from sqlalchemy.ext.asyncio import AsyncSession
 
 async def upsert_order(session: AsyncSession, order_table, values: dict) -> None:
-    dialect_name = session.bind.dialect.name
+    bind = session.bind if session.bind is not None else session.get_bind()
+    dialect_name = bind.dialect.name
     if not OnConflictUpsert.supports_native_upsert(dialect_name):
         raise RuntimeError(f"native upsert unsupported for {dialect_name}")
     stmt = OnConflictUpsert.create_upsert(

skills/advanced-alchemy/SKILL.md

@@ -40,7 +40,7 @@ Advanced Alchemy is NOT a raw ORM — it is a **service/repository layer** built
 | `UUIDBase` | UUID v4 | None | Lookup tables, tags, no audit needed |
 | `UUIDv7AuditBase` | UUID v7 | `created_at`, `updated_at` | Time-sortable IDs (preferred over v6) |
 | `BigIntAuditBase` | BigInt auto-increment | `created_at`, `updated_at` | Legacy systems, integer PKs |
-| `NanoidAuditBase` | Nanoid string | `created_at`, `updated_at` | URL-friendly short IDs |
+| `NanoIDAuditBase` | NanoID string | `created_at`, `updated_at` | URL-friendly short IDs |
 | `DeclarativeBase` | None (define yourself) | None | Full schema control |
 
 ### Repository Pattern
@@ -83,7 +83,7 @@ Key lifecycle hooks: `to_model_on_create`, `to_model_on_update`, `to_model_on_up
 | Mixin | Fields Added | When to Use |
 | --- | --- | --- |
 | `AuditMixin` | `created_at`, `updated_at`, `created_by`, `updated_by` | Any model needing a full audit trail (who + when) |
-| `SlugMixin` | `slug` (auto-generated) | URL-friendly identifiers derived from another field |
+| `SlugKey` | `slug` (auto-generated) | URL-friendly identifiers derived from another field |
 | `UniqueMixin` | `get_or_create` class method | Idempotent inserts for lookup/reference tables |
 | `SentinelMixin` | `_sentinel` version column | Optimistic locking; raises `ConflictError` on stale writes |
 

skills/advanced-alchemy/references/fastapi-integration.md

@@ -118,14 +118,21 @@ from uuid import UUID
 
 from fastapi import APIRouter, Depends
 from pydantic import BaseModel
-from sqlalchemy.orm import Mapped, mapped_column
+from sqlalchemy import ForeignKey
+from sqlalchemy.orm import Mapped, mapped_column, relationship
 
-from advanced_alchemy.base import UUIDBase
+from advanced_alchemy.base import UUIDAuditBase
 from advanced_alchemy.repository import SQLAlchemyAsyncRepository
 from advanced_alchemy.service import SQLAlchemyAsyncRepositoryService
 
-class OrderModel(UUIDBase):
+class CustomerModel(UUIDAuditBase):
+    __tablename__ = "customer"
+    name: Mapped[str] = mapped_column()
+
+class OrderModel(UUIDAuditBase):
     __tablename__ = "order"
+    customer_id: Mapped[UUID] = mapped_column(ForeignKey("customer.id"))
+    customer: Mapped[CustomerModel] = relationship()
     customer_email: Mapped[str] = mapped_column()
     total_cents: Mapped[int] = mapped_column()
 
@@ -288,7 +295,7 @@ from pydantic import BaseModel
 from sqlalchemy.orm import Mapped, mapped_column
 
 from advanced_alchemy import filters
-from advanced_alchemy.base import UUIDBase
+from advanced_alchemy.base import UUIDAuditBase
 from advanced_alchemy.repository import SQLAlchemyAsyncRepository
 from advanced_alchemy.service import OffsetPagination, SQLAlchemyAsyncRepositoryService
 from advanced_alchemy.extensions.fastapi import (
@@ -298,7 +305,7 @@ from advanced_alchemy.extensions.fastapi import (
     assign_cli_group,
 )
 
-class OrderModel(UUIDBase):
+class OrderModel(UUIDAuditBase):
     __tablename__ = "order"
     customer_email: Mapped[str] = mapped_column()
     total_cents: Mapped[int] = mapped_column()

skills/advanced-alchemy/references/operations.md

@@ -15,7 +15,8 @@ from advanced_alchemy.operations import OnConflictUpsert
 from sqlalchemy.ext.asyncio import AsyncSession
 
 async def upsert_order(session: AsyncSession, order_table, values: dict) -> None:
-    dialect_name = session.bind.dialect.name
+    bind = session.bind if session.bind is not None else session.get_bind()
+    dialect_name = bind.dialect.name
     if not OnConflictUpsert.supports_native_upsert(dialect_name):
         raise RuntimeError(f"native upsert unsupported for {dialect_name}")
     stmt = OnConflictUpsert.create_upsert(