unitysvc-core 0.1.0__tar.gz

unitysvc_core-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025, Bo Peng
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

unitysvc_core-0.1.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: unitysvc-core
+Version: 0.1.0
+Summary: Shared data models and validation helpers for UnitySVC packages
+Author-email: Bo Peng <bo.peng@unitysvc.com>
+Maintainer-email: Bo Peng <bo.peng@unitysvc.com>
+License-Expression: MIT
+Project-URL: bugs, https://github.com/unitysvc/unitysvc-core/issues
+Project-URL: homepage, https://github.com/unitysvc/unitysvc-core
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2
+Requires-Dist: email-validator
+Requires-Dist: jsonschema
+Requires-Dist: jinja2
+Requires-Dist: json5
+Requires-Dist: tomli-w
+Provides-Extra: test
+Requires-Dist: coverage; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: ruff; extra == "test"
+Requires-Dist: mypy; extra == "test"
+Provides-Extra: dev
+Requires-Dist: coverage; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: ty; extra == "dev"
+Requires-Dist: ipdb; extra == "dev"
+Dynamic: license-file
+
+# unitysvc-core
+
+Shared data models, JSON schemas, and validation helpers for the UnitySVC
+ecosystem. This package is **audience-neutral**: it contains only the
+foundational types and helpers that are consumed by the UnitySVC backend,
+the customer SDK, the admin CLI, and the seller SDK.
+
+It intentionally does **not** include any CLI, HTTP client, or
+audience-specific helpers. Those live in the corresponding packages:
+
+- `unitysvc-sellers` — seller SDK + `usvc_seller` CLI, catalog builders
+  (`populate_from_iterator`, `render_template_file`,
+  `convert_convenience_fields_to_documents`, etc.)
+- `unitysvc` — customer SDK + `usvc` CLI
+- `unitysvc-admin` — admin CLI
+
+## What's inside
+
+```
+src/unitysvc_core/
+├── models/
+│   ├── base.py            # All enums (status, type, currency, rate-limit, etc.)
+│   ├── pricing.py         # PriceStr, UsageData, all *PriceData classes,
+│   │                      # Pricing union, validate_pricing, cost calculation
+│   ├── documents.py       # DocumentData
+│   ├── service.py         # RateLimit, ServiceConstraints, AccessInterfaceData,
+│   │                      # UpstreamAccessConfigData
+│   ├── validators.py      # validate_name, validate_service_options,
+│   │                      # suggest_valid_name, SUPPORTED_SERVICE_OPTIONS
+│   ├── provider_v1.py     # Provider file schema + ProviderData
+│   ├── offering_v1.py     # Offering file schema + ServiceOfferingData
+│   ├── listing_v1.py      # Listing file schema + ServiceListingData
+│   ├── promotion_v1.py    # Promotion file schema + PromotionData
+│   └── service_group_v1.py
+├── schema/                # Generated JSON schemas
+├── validator.py           # DataValidator — per-file schema validation,
+│                          # union-field reference checks, API-key secret
+│                          # scanning, Jinja2 syntax validation, etc.
+└── utils.py               # Content hashing, mime/extension helpers,
+                           # data file loaders (JSON/TOML + overrides),
+                           # schema-based file discovery
+```
+
+### What's deliberately NOT here
+
+- **CLI code** — `typer`, `rich`, no entry points
+- **HTTP clients** — no `httpx`, no API wrappers
+- **Seller catalog builders** — `populate_from_iterator`,
+  `render_template_file`, `convert_convenience_fields_to_documents`,
+  `execute_script_content` live in `unitysvc-sellers`
+- **Seller-catalog-layout validation** — `validate_provider_status`,
+  `validate_all_service_directories`, `resolve_provider_name`,
+  `resolve_service_name_for_listing` live in `unitysvc-sellers`
+
+## Installation
+
+```bash
+pip install unitysvc-core
+```
+
+Dependencies: `pydantic`, `email-validator`, `jsonschema`, `jinja2`,
+`json5`, `tomli-w`. No `typer`, no `rich`, no `httpx`.
+
+## Usage
+
+```python
+from pathlib import Path
+
+import unitysvc_core
+from unitysvc_core.models import ProviderV1, OfferingV1, ListingV1
+from unitysvc_core.models.pricing import UsageData, validate_pricing
+from unitysvc_core.validator import DataValidator
+
+# Validate a single catalog directory
+validator = DataValidator(
+    data_dir=Path("./catalog"),
+    schema_dir=Path(unitysvc_core.__file__).parent / "schema",
+)
+results = validator.validate_all()
+
+# Typed pricing + cost calculation
+pricing = validate_pricing({
+    "type": "one_million_tokens",
+    "input": "0.50",
+    "output": "1.50",
+})
+cost = pricing.calculate_cost(UsageData(input_tokens=1_000, output_tokens=500))
+```
+
+## History
+
+This package was split out of `unitysvc-services` (see
+[unitysvc/unitysvc-services#99](https://github.com/unitysvc/unitysvc-services/issues/99)).
+The seller CLI, catalog builders, and seller-catalog-layout validators
+moved to `unitysvc-sellers`.
+
+## License
+
+MIT

unitysvc_core-0.1.0/README.md

@@ -0,0 +1,99 @@
+# unitysvc-core
+
+Shared data models, JSON schemas, and validation helpers for the UnitySVC
+ecosystem. This package is **audience-neutral**: it contains only the
+foundational types and helpers that are consumed by the UnitySVC backend,
+the customer SDK, the admin CLI, and the seller SDK.
+
+It intentionally does **not** include any CLI, HTTP client, or
+audience-specific helpers. Those live in the corresponding packages:
+
+- `unitysvc-sellers` — seller SDK + `usvc_seller` CLI, catalog builders
+  (`populate_from_iterator`, `render_template_file`,
+  `convert_convenience_fields_to_documents`, etc.)
+- `unitysvc` — customer SDK + `usvc` CLI
+- `unitysvc-admin` — admin CLI
+
+## What's inside
+
+```
+src/unitysvc_core/
+├── models/
+│   ├── base.py            # All enums (status, type, currency, rate-limit, etc.)
+│   ├── pricing.py         # PriceStr, UsageData, all *PriceData classes,
+│   │                      # Pricing union, validate_pricing, cost calculation
+│   ├── documents.py       # DocumentData
+│   ├── service.py         # RateLimit, ServiceConstraints, AccessInterfaceData,
+│   │                      # UpstreamAccessConfigData
+│   ├── validators.py      # validate_name, validate_service_options,
+│   │                      # suggest_valid_name, SUPPORTED_SERVICE_OPTIONS
+│   ├── provider_v1.py     # Provider file schema + ProviderData
+│   ├── offering_v1.py     # Offering file schema + ServiceOfferingData
+│   ├── listing_v1.py      # Listing file schema + ServiceListingData
+│   ├── promotion_v1.py    # Promotion file schema + PromotionData
+│   └── service_group_v1.py
+├── schema/                # Generated JSON schemas
+├── validator.py           # DataValidator — per-file schema validation,
+│                          # union-field reference checks, API-key secret
+│                          # scanning, Jinja2 syntax validation, etc.
+└── utils.py               # Content hashing, mime/extension helpers,
+                           # data file loaders (JSON/TOML + overrides),
+                           # schema-based file discovery
+```
+
+### What's deliberately NOT here
+
+- **CLI code** — `typer`, `rich`, no entry points
+- **HTTP clients** — no `httpx`, no API wrappers
+- **Seller catalog builders** — `populate_from_iterator`,
+  `render_template_file`, `convert_convenience_fields_to_documents`,
+  `execute_script_content` live in `unitysvc-sellers`
+- **Seller-catalog-layout validation** — `validate_provider_status`,
+  `validate_all_service_directories`, `resolve_provider_name`,
+  `resolve_service_name_for_listing` live in `unitysvc-sellers`
+
+## Installation
+
+```bash
+pip install unitysvc-core
+```
+
+Dependencies: `pydantic`, `email-validator`, `jsonschema`, `jinja2`,
+`json5`, `tomli-w`. No `typer`, no `rich`, no `httpx`.
+
+## Usage
+
+```python
+from pathlib import Path
+
+import unitysvc_core
+from unitysvc_core.models import ProviderV1, OfferingV1, ListingV1
+from unitysvc_core.models.pricing import UsageData, validate_pricing
+from unitysvc_core.validator import DataValidator
+
+# Validate a single catalog directory
+validator = DataValidator(
+    data_dir=Path("./catalog"),
+    schema_dir=Path(unitysvc_core.__file__).parent / "schema",
+)
+results = validator.validate_all()
+
+# Typed pricing + cost calculation
+pricing = validate_pricing({
+    "type": "one_million_tokens",
+    "input": "0.50",
+    "output": "1.50",
+})
+cost = pricing.calculate_cost(UsageData(input_tokens=1_000, output_tokens=500))
+```
+
+## History
+
+This package was split out of `unitysvc-services` (see
+[unitysvc/unitysvc-services#99](https://github.com/unitysvc/unitysvc-services/issues/99)).
+The seller CLI, catalog builders, and seller-catalog-layout validators
+moved to `unitysvc-sellers`.
+
+## License
+
+MIT

unitysvc_core-0.1.0/pyproject.toml

@@ -0,0 +1,79 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "unitysvc-core"
+version = "0.1.0"
+description = "Shared data models and validation helpers for UnitySVC packages"
+readme = "README.md"
+authors = [{ name = "Bo Peng", email = "bo.peng@unitysvc.com" }]
+maintainers = [{ name = "Bo Peng", email = "bo.peng@unitysvc.com" }]
+license = "MIT"
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Operating System :: OS Independent",
+  "Typing :: Typed",
+]
+dependencies = [
+  "pydantic>=2",
+  "email-validator",
+  "jsonschema",
+  "jinja2",
+  "json5",
+  "tomli-w",
+]
+requires-python = ">= 3.11"
+
+[project.optional-dependencies]
+test = [
+  "coverage",
+  "pytest",
+  "ruff",
+  "mypy",
+]
+dev = [
+  "coverage",
+  "pytest",
+  "ruff",
+  "ty",
+  "ipdb",
+]
+
+[project.urls]
+bugs = "https://github.com/unitysvc/unitysvc-core/issues"
+homepage = "https://github.com/unitysvc/unitysvc-core"
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+select = [
+  "E",  # pycodestyle errors
+  "W",  # pycodestyle warnings
+  "F",  # Pyflakes
+  "I",  # isort
+  "B",  # flake8-bugbear
+  "UP", # pyupgrade
+]
+ignore = [
+  "B904",
+]
+
+[tool.mypy]
+ignore_missing_imports = true
+warn_unused_ignores = false
+disable_error_code = ["import-untyped"]
+
+[tool.uv]
+package = true
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.package-data]
+unitysvc_core = ["schema/*.json", "py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

unitysvc_core-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

unitysvc_core-0.1.0/src/unitysvc_core/__init__.py

@@ -0,0 +1,32 @@
+"""UnitySVC Core — shared data models and validation helpers.
+
+This package is audience-neutral. It contains the pydantic models, JSON
+schemas, and validator consumed by the UnitySVC backend, the customer SDK,
+the admin CLI, and the seller SDK.
+
+It intentionally does NOT include any CLI, HTTP client, or audience-
+specific helpers (seller catalog builders, customer query helpers, etc.).
+Those live in the corresponding audience packages (``unitysvc-sellers``,
+``unitysvc`` customer SDK, ``unitysvc-admin``).
+"""
+
+__author__ = """Bo Peng"""
+__email__ = "bo.peng@unitysvc.com"
+
+# Shared file / data utilities used by the backend and SDK consumers
+from .utils import (
+    compute_file_hash,
+    generate_content_based_key,
+    get_basename,
+    get_file_extension,
+    mime_type_to_extension,
+)
+
+__all__ = [
+    # File utilities
+    "compute_file_hash",
+    "generate_content_based_key",
+    "get_basename",
+    "get_file_extension",
+    "mime_type_to_extension",
+]

unitysvc_core-0.1.0/src/unitysvc_core/models/__init__.py

@@ -0,0 +1,171 @@
+from .base import (
+    AccessMethodEnum,
+    AuthMethodEnum,
+    ContentFilterEnum,
+    CurrencyEnum,
+    DocumentCategoryEnum,
+    DocumentContextEnum,
+    ListingStatusEnum,
+    MimeTypeEnum,
+    OfferingStatusEnum,
+    OveragePolicyEnum,
+    PriceRuleApplyAtEnum,
+    PriceRuleStatusEnum,
+    PricingTypeEnum,
+    ProviderStatusEnum,
+    QuotaResetCycleEnum,
+    RateLimitUnitEnum,
+    RequestTransformEnum,
+    SellerTypeEnum,
+    ServiceGroupStatusEnum,
+    ServiceTypeEnum,
+    TimeWindowEnum,
+    UpstreamStatusEnum,  # Backwards compatibility alias for OfferingStatusEnum
+)
+from .documents import DocumentData
+from .listing_data import ServiceListingData
+from .listing_v1 import ListingV1
+from .offering_data import ServiceOfferingData
+from .offering_v1 import OfferingV1
+from .pricing import (
+    AddPriceData,
+    BasePriceData,
+    ConstantPriceData,
+    CountPriceData,
+    DataPriceData,
+    ExprPriceData,
+    FirstPriceData,
+    GraduatedPriceData,
+    GraduatedTier,
+    ImagePriceData,
+    MaxPriceData,
+    MinPriceData,
+    MultiplyPriceData,
+    PercentageStr,
+    PriceStr,
+    PriceTier,
+    Pricing,
+    RevenueSharePriceData,
+    StepPriceData,
+    TieredPriceData,
+    TimePriceData,
+    TokenPriceData,
+    UsageData,
+    validate_pricing,
+)
+from .promotion_data import (
+    PROMOTION_SCHEMA_VERSION,
+    PromotionData,
+    describe_scope,
+    is_promotion_file,
+    strip_schema_field,
+    validate_promotion,
+)
+from .promotion_v1 import PromotionV1
+from .provider_data import ProviderData
+from .provider_v1 import ProviderV1
+from .service import (
+    AccessInterfaceData,
+    RateLimit,
+    ServiceConstraints,
+    UpstreamAccessConfigData,
+)
+from .service_group_data import (
+    SERVICE_GROUP_SCHEMA_VERSION,
+    ServiceGroupData,
+    is_service_group_file,
+    validate_service_group,
+)
+from .service_group_v1 import ServiceGroupV1
+from .validators import (
+    SUPPORTED_SERVICE_OPTIONS,
+    suggest_valid_name,
+    validate_name,
+    validate_service_options,
+)
+
+__all__ = [
+    # V1 models (for file validation)
+    "ProviderV1",
+    "OfferingV1",
+    "ListingV1",
+    "PromotionV1",
+    "ServiceGroupV1",
+    # Data models (for API/backend use)
+    "ProviderData",
+    "ServiceOfferingData",
+    "ServiceListingData",
+    "PromotionData",
+    "ServiceGroupData",
+    # Shared / access models
+    "DocumentData",
+    "AccessInterfaceData",
+    "UpstreamAccessConfigData",
+    "RateLimit",
+    "ServiceConstraints",
+    # Enums
+    "AccessMethodEnum",
+    "AuthMethodEnum",
+    "ContentFilterEnum",
+    "CurrencyEnum",
+    "DocumentCategoryEnum",
+    "DocumentContextEnum",
+    "ListingStatusEnum",
+    "MimeTypeEnum",
+    "OfferingStatusEnum",
+    "OveragePolicyEnum",
+    "PriceRuleApplyAtEnum",
+    "PriceRuleStatusEnum",
+    "PricingTypeEnum",
+    "ProviderStatusEnum",
+    "QuotaResetCycleEnum",
+    "RateLimitUnitEnum",
+    "RequestTransformEnum",
+    "SellerTypeEnum",
+    "ServiceGroupStatusEnum",
+    "ServiceTypeEnum",
+    "TimeWindowEnum",
+    "UpstreamStatusEnum",  # Backwards compatibility alias for OfferingStatusEnum
+    # Pricing — primitives
+    "PriceStr",
+    "PercentageStr",
+    "UsageData",
+    "Pricing",
+    "validate_pricing",
+    "BasePriceData",
+    # Pricing — simple types
+    "TokenPriceData",
+    "TimePriceData",
+    "DataPriceData",
+    "CountPriceData",
+    "ImagePriceData",
+    "StepPriceData",
+    "RevenueSharePriceData",
+    "ConstantPriceData",
+    # Pricing — composite types
+    "AddPriceData",
+    "MultiplyPriceData",
+    "MaxPriceData",
+    "MinPriceData",
+    "FirstPriceData",
+    "TieredPriceData",
+    "GraduatedPriceData",
+    "ExprPriceData",
+    "PriceTier",
+    "GraduatedTier",
+    # Validators
+    "SUPPORTED_SERVICE_OPTIONS",
+    "validate_name",
+    "validate_service_options",
+    "suggest_valid_name",
+    # Promotions
+    "PROMOTION_SCHEMA_VERSION",
+    "is_promotion_file",
+    "describe_scope",
+    "strip_schema_field",
+    "validate_promotion",
+    # Service Groups
+    "SERVICE_GROUP_SCHEMA_VERSION",
+    "is_service_group_file",
+    "validate_service_group",
+]