b1sl-python 0.1.0__py3-none-any.whl

b1sl/b1sl/fields/_generated/entities/production.py

@@ -0,0 +1,256 @@
+from __future__ import annotations
+from enum import StrEnum
+
+class ProductTreeFields(StrEnum):
+    tree_code = 'TreeCode'
+    tree_type = 'TreeType'
+    quantity = 'Quantity'
+    distribution_rule = 'DistributionRule'
+    project = 'Project'
+    distribution_rule2 = 'DistributionRule2'
+    distribution_rule3 = 'DistributionRule3'
+    distribution_rule4 = 'DistributionRule4'
+    distribution_rule5 = 'DistributionRule5'
+    price_list = 'PriceList'
+    warehouse = 'Warehouse'
+    plan_avg_prod_size = 'PlanAvgProdSize'
+    hide_bom_components_in_printout = 'HideBOMComponentsInPrintout'
+    product_description = 'ProductDescription'
+    attachment_entry = 'AttachmentEntry'
+    product_tree_lines = 'ProductTreeLines'
+    product_tree_stages = 'ProductTreeStages'
+    item = 'Item'
+    distribution_rule6 = 'DistributionRule6'
+    project2 = 'Project2'
+    price_list2 = 'PriceList2'
+    attachments2 = 'Attachments2'
+    production_orders = 'ProductionOrders'
+
+class ProductionOrderFields(StrEnum):
+    absolute_entry = 'AbsoluteEntry'
+    document_number = 'DocumentNumber'
+    series = 'Series'
+    item_no = 'ItemNo'
+    production_order_status = 'ProductionOrderStatus'
+    production_order_type = 'ProductionOrderType'
+    planned_quantity = 'PlannedQuantity'
+    completed_quantity = 'CompletedQuantity'
+    rejected_quantity = 'RejectedQuantity'
+    posting_date = 'PostingDate'
+    due_date = 'DueDate'
+    production_order_origin_entry = 'ProductionOrderOriginEntry'
+    production_order_origin_number = 'ProductionOrderOriginNumber'
+    production_order_origin = 'ProductionOrderOrigin'
+    user_signature = 'UserSignature'
+    remarks = 'Remarks'
+    closing_date = 'ClosingDate'
+    release_date = 'ReleaseDate'
+    customer_code = 'CustomerCode'
+    warehouse = 'Warehouse'
+    inventory_uom = 'InventoryUOM'
+    journal_remarks = 'JournalRemarks'
+    transaction_number = 'TransactionNumber'
+    creation_date = 'CreationDate'
+    printed = 'Printed'
+    distribution_rule = 'DistributionRule'
+    project = 'Project'
+    distribution_rule2 = 'DistributionRule2'
+    distribution_rule3 = 'DistributionRule3'
+    distribution_rule4 = 'DistributionRule4'
+    distribution_rule5 = 'DistributionRule5'
+    uo_m_entry = 'UoMEntry'
+    start_date = 'StartDate'
+    product_description = 'ProductDescription'
+    priority = 'Priority'
+    routing_date_calculation = 'RoutingDateCalculation'
+    update_allocation = 'UpdateAllocation'
+    sap_passport = 'SAPPassport'
+    attachment_entry = 'AttachmentEntry'
+    pick_remarks = 'PickRemarks'
+    production_order_lines = 'ProductionOrderLines'
+    production_orders_sales_order_lines = 'ProductionOrdersSalesOrderLines'
+    production_orders_stages = 'ProductionOrdersStages'
+    production_orders_document_references = 'ProductionOrdersDocumentReferences'
+    product_tree = 'ProductTree'
+    user = 'User'
+    business_partner = 'BusinessPartner'
+    warehouse2 = 'Warehouse2'
+    journal_entry = 'JournalEntry'
+    distribution_rule6 = 'DistributionRule6'
+    project2 = 'Project2'
+    unit_of_measurement = 'UnitOfMeasurement'
+    attachments2 = 'Attachments2'
+
+class ResourceFields(StrEnum):
+    code = 'Code'
+    vis_code = 'VisCode'
+    series = 'Series'
+    number = 'Number'
+    code_bar = 'CodeBar'
+    name = 'Name'
+    foreign_name = 'ForeignName'
+    type = 'Type'
+    group = 'Group'
+    unit_of_measure = 'UnitOfMeasure'
+    issue_method = 'IssueMethod'
+    cost1 = 'Cost1'
+    cost2 = 'Cost2'
+    cost3 = 'Cost3'
+    cost4 = 'Cost4'
+    cost5 = 'Cost5'
+    cost6 = 'Cost6'
+    cost7 = 'Cost7'
+    cost8 = 'Cost8'
+    cost9 = 'Cost9'
+    cost10 = 'Cost10'
+    active = 'Active'
+    active_from = 'ActiveFrom'
+    active_to = 'ActiveTo'
+    inactive = 'Inactive'
+    inactive_from = 'InactiveFrom'
+    inactive_to = 'InactiveTo'
+    default_warehouse = 'DefaultWarehouse'
+    picture = 'Picture'
+    remarks = 'Remarks'
+    property1 = 'Property1'
+    property2 = 'Property2'
+    property3 = 'Property3'
+    property4 = 'Property4'
+    property5 = 'Property5'
+    property6 = 'Property6'
+    property7 = 'Property7'
+    property8 = 'Property8'
+    property9 = 'Property9'
+    property10 = 'Property10'
+    property11 = 'Property11'
+    property12 = 'Property12'
+    property13 = 'Property13'
+    property14 = 'Property14'
+    property15 = 'Property15'
+    property16 = 'Property16'
+    property17 = 'Property17'
+    property18 = 'Property18'
+    property19 = 'Property19'
+    property20 = 'Property20'
+    property21 = 'Property21'
+    property22 = 'Property22'
+    property23 = 'Property23'
+    property24 = 'Property24'
+    property25 = 'Property25'
+    property26 = 'Property26'
+    property27 = 'Property27'
+    property28 = 'Property28'
+    property29 = 'Property29'
+    property30 = 'Property30'
+    property31 = 'Property31'
+    property32 = 'Property32'
+    property33 = 'Property33'
+    property34 = 'Property34'
+    property35 = 'Property35'
+    property36 = 'Property36'
+    property37 = 'Property37'
+    property38 = 'Property38'
+    property39 = 'Property39'
+    property40 = 'Property40'
+    property41 = 'Property41'
+    property42 = 'Property42'
+    property43 = 'Property43'
+    property44 = 'Property44'
+    property45 = 'Property45'
+    property46 = 'Property46'
+    property47 = 'Property47'
+    property48 = 'Property48'
+    property49 = 'Property49'
+    property50 = 'Property50'
+    property51 = 'Property51'
+    property52 = 'Property52'
+    property53 = 'Property53'
+    property54 = 'Property54'
+    property55 = 'Property55'
+    property56 = 'Property56'
+    property57 = 'Property57'
+    property58 = 'Property58'
+    property59 = 'Property59'
+    property60 = 'Property60'
+    property61 = 'Property61'
+    property62 = 'Property62'
+    property63 = 'Property63'
+    property64 = 'Property64'
+    active_remarks = 'ActiveRemarks'
+    inactive_remarks = 'InactiveRemarks'
+    attachment_entry = 'AttachmentEntry'
+    units_per_time = 'UnitsPerTime'
+    time_per_units = 'TimePerUnits'
+    allocation = 'Allocation'
+    linked_item = 'LinkedItem'
+    relevant_for_single_run1 = 'RelevantForSingleRun1'
+    relevant_for_single_run2 = 'RelevantForSingleRun2'
+    relevant_for_single_run3 = 'RelevantForSingleRun3'
+    relevant_for_single_run4 = 'RelevantForSingleRun4'
+    resource_warehouses = 'ResourceWarehouses'
+    resource_fixed_assets = 'ResourceFixedAssets'
+    resource_employees = 'ResourceEmployees'
+    resource_daily_capacities = 'ResourceDailyCapacities'
+    items = 'Items'
+    resource_capacities = 'ResourceCapacities'
+    resource_group = 'ResourceGroup'
+    item = 'Item'
+
+class ResourceCapacityFields(StrEnum):
+    id = 'Id'
+    code = 'Code'
+    warehouse = 'Warehouse'
+    date = 'Date'
+    type = 'Type'
+    capacity = 'Capacity'
+    source_type = 'SourceType'
+    source_entry = 'SourceEntry'
+    source_line_num = 'SourceLineNum'
+    base_type = 'BaseType'
+    base_entry = 'BaseEntry'
+    base_line_num = 'BaseLineNum'
+    action = 'Action'
+    owning_type = 'OwningType'
+    owning_entry = 'OwningEntry'
+    owning_line_num = 'OwningLineNum'
+    reverted_type = 'RevertedType'
+    reverted_entry = 'RevertedEntry'
+    reverted_line_num = 'RevertedLineNum'
+    memo_source = 'MemoSource'
+    memo = 'Memo'
+    single_run_capacity = 'SingleRunCapacity'
+    single_run_memo_source = 'SingleRunMemoSource'
+    single_run_memo = 'SingleRunMemo'
+    resource = 'Resource'
+    warehouse2 = 'Warehouse2'
+
+class ResourceGroupFields(StrEnum):
+    code = 'Code'
+    name = 'Name'
+    type = 'Type'
+    cost_name1 = 'CostName1'
+    cost1 = 'Cost1'
+    cost_name2 = 'CostName2'
+    cost2 = 'Cost2'
+    cost_name3 = 'CostName3'
+    cost3 = 'Cost3'
+    cost_name4 = 'CostName4'
+    cost4 = 'Cost4'
+    cost_name5 = 'CostName5'
+    cost5 = 'Cost5'
+    cost_name6 = 'CostName6'
+    cost6 = 'Cost6'
+    cost_name7 = 'CostName7'
+    cost7 = 'Cost7'
+    cost_name8 = 'CostName8'
+    cost8 = 'Cost8'
+    cost_name9 = 'CostName9'
+    cost9 = 'Cost9'
+    cost_name10 = 'CostName10'
+    cost10 = 'Cost10'
+    num_of_units_text = 'NumOfUnitsText'
+    resources = 'Resources'
+
+class ResourcePropertyFields(StrEnum):
+    code = 'Code'
+    name = 'Name'

b1sl/b1sl/fields/_generated/entities/purchasing.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+from enum import StrEnum
+
+class LandedCostFields(StrEnum):
+    doc_entry = 'DocEntry'
+    landed_cost_number = 'LandedCostNumber'
+    posting_date = 'PostingDate'
+    due_date = 'DueDate'
+    vendor_code = 'VendorCode'
+    vendor_name = 'VendorName'
+    broker = 'Broker'
+    broker_name = 'BrokerName'
+    closed_document = 'ClosedDocument'
+    file_number = 'FileNumber'
+    remarks = 'Remarks'
+    reference = 'Reference'
+    document_currency = 'DocumentCurrency'
+    document_rate = 'DocumentRate'
+    projected_customs = 'ProjectedCustoms'
+    actual_customs = 'ActualCustoms'
+    actual_customs_fc = 'ActualCustomsFC'
+    tax1 = 'Tax1'
+    tax2 = 'Tax2'
+    before_tax = 'BeforeTax'
+    total = 'Total'
+    total_freight_charges = 'TotalFreightCharges'
+    projected_customs_fc = 'ProjectedCustomsFC'
+    tax1_fc = 'Tax1FC'
+    tax2_fc = 'Tax2FC'
+    before_tax_fc = 'BeforeTaxFC'
+    total_fc = 'TotalFC'
+    total_freight_charges_fc = 'TotalFreightChargesFC'
+    series = 'Series'
+    customs_affects_inventory = 'CustomsAffectsInventory'
+    amount_to_balance = 'AmountToBalance'
+    amount_to_balance_fc = 'AmountToBalanceFC'
+    billof_lading_number = 'BillofLadingNumber'
+    transport_type = 'TransportType'
+    transaction_number = 'TransactionNumber'
+    journal_remarks = 'JournalRemarks'
+    attachment_entry = 'AttachmentEntry'
+    landed_cost_item_lines = 'LandedCost_ItemLines'
+    landed_cost_cost_lines = 'LandedCost_CostLines'
+    business_partner = 'BusinessPartner'
+    shipping_type = 'ShippingType'
+    journal_entry = 'JournalEntry'
+    purchase_delivery_notes = 'PurchaseDeliveryNotes'
+
+class LandedCostsCodeFields(StrEnum):
+    code = 'Code'
+    name = 'Name'
+    allocation_by = 'AllocationBy'
+    landed_costs_allocation_account = 'LandedCostsAllocationAccount'

b1sl/b1sl/fields/_generated/entities/sales.py

@@ -0,0 +1,244 @@
+from __future__ import annotations
+from enum import StrEnum
+
+class BlanketAgreementFields(StrEnum):
+    agreement_no = 'AgreementNo'
+    bp_code = 'BPCode'
+    bp_name = 'BPName'
+    contact_person_code = 'ContactPersonCode'
+    start_date = 'StartDate'
+    end_date = 'EndDate'
+    terminate_date = 'TerminateDate'
+    description = 'Description'
+    agreement_type = 'AgreementType'
+    status = 'Status'
+    owner = 'Owner'
+    ignore_prices_in_agreement = 'IgnorePricesInAgreement'
+    renewal = 'Renewal'
+    remind_unit = 'RemindUnit'
+    remind_time = 'RemindTime'
+    remarks = 'Remarks'
+    attachment_entry = 'AttachmentEntry'
+    settlement_probability = 'SettlementProbability'
+    agreement_method = 'AgreementMethod'
+    payment_terms = 'PaymentTerms'
+    price_list = 'PriceList'
+    signing_date = 'SigningDate'
+    amendment_to = 'AmendmentTo'
+    series = 'Series'
+    doc_num = 'DocNum'
+    hand_written = 'HandWritten'
+    period_indicator = 'PeriodIndicator'
+    payment_method = 'PaymentMethod'
+    exchange_rate = 'ExchangeRate'
+    shipping_type = 'ShippingType'
+    num_at_card = 'NumAtCard'
+    project = 'Project'
+    price_mode = 'PriceMode'
+    bp_currency = 'BPCurrency'
+    bp_type = 'BPType'
+    sap_passport = 'SAPPassport'
+    blanket_agreements_items_lines = 'BlanketAgreements_ItemsLines'
+    vendor_payments = 'VendorPayments'
+    journal_entries = 'JournalEntries'
+    business_partner = 'BusinessPartner'
+    employee_info = 'EmployeeInfo'
+    attachments2 = 'Attachments2'
+    payment_terms_type = 'PaymentTermsType'
+    price_list2 = 'PriceList2'
+    wizard_payment_method = 'WizardPaymentMethod'
+    shipping_type2 = 'ShippingType2'
+    project2 = 'Project2'
+    currency = 'Currency'
+    payment_drafts = 'PaymentDrafts'
+    business_partners = 'BusinessPartners'
+    incoming_payments = 'IncomingPayments'
+
+class ContractTemplateFields(StrEnum):
+    template_name = 'TemplateName'
+    template_is_deleted = 'TemplateIsDeleted'
+    template_is_renewal = 'TemplateIsRenewal'
+    remind_before_renewal = 'RemindBeforeRenewal'
+    remind_unit = 'RemindUnit'
+    duration_of_coverage = 'DurationOfCoverage'
+    response_value = 'ResponseValue'
+    resolution_unit = 'ResolutionUnit'
+    description = 'Description'
+    contract_type = 'ContractType'
+    monday_enabled = 'MondayEnabled'
+    tuesday_enabled = 'TuesdayEnabled'
+    wednesday_enabled = 'WednesdayEnabled'
+    thursday_enabled = 'ThursdayEnabled'
+    friday_enabled = 'FridayEnabled'
+    saturday_enabled = 'SaturdayEnabled'
+    sunday_enabled = 'SundayEnabled'
+    monday_start = 'MondayStart'
+    monday_end = 'MondayEnd'
+    tuesday_start = 'TuesdayStart'
+    tuesday_end = 'TuesdayEnd'
+    wednesday_start = 'WednesdayStart'
+    wednesday_end = 'WednesdayEnd'
+    thursday_start = 'ThursdayStart'
+    thursday_end = 'ThursdayEnd'
+    friday_start = 'FridayStart'
+    friday_end = 'FridayEnd'
+    saturday_start = 'SaturdayStart'
+    saturday_end = 'SaturdayEnd'
+    sunday_start = 'SundayStart'
+    sunday_end = 'SundayEnd'
+    include_parts = 'IncludeParts'
+    include_labor = 'IncludeLabor'
+    include_travel = 'IncludeTravel'
+    remarks = 'Remarks'
+    include_holidays = 'IncludeHolidays'
+    response_unit = 'ResponseUnit'
+    resolution_time = 'ResolutionTime'
+    attachment_entry = 'AttachmentEntry'
+    items = 'Items'
+    service_contracts = 'ServiceContracts'
+
+class ServiceCallFields(StrEnum):
+    service_call_id = 'ServiceCallID'
+    subject = 'Subject'
+    customer_code = 'CustomerCode'
+    customer_name = 'CustomerName'
+    contact_code = 'ContactCode'
+    manufacturer_serial_num = 'ManufacturerSerialNum'
+    internal_serial_num = 'InternalSerialNum'
+    contract_id = 'ContractID'
+    contract_end_date = 'ContractEndDate'
+    resolution_date = 'ResolutionDate'
+    resolution_time = 'ResolutionTime'
+    origin = 'Origin'
+    item_code = 'ItemCode'
+    item_description = 'ItemDescription'
+    item_group_code = 'ItemGroupCode'
+    status = 'Status'
+    priority = 'Priority'
+    call_type = 'CallType'
+    problem_type = 'ProblemType'
+    assignee_code = 'AssigneeCode'
+    description = 'Description'
+    technician_code = 'TechnicianCode'
+    resolution = 'Resolution'
+    creation_date = 'CreationDate'
+    creation_time = 'CreationTime'
+    responder = 'Responder'
+    updated_time = 'UpdatedTime'
+    belongs_to_a_queue = 'BelongsToAQueue'
+    response_by_time = 'ResponseByTime'
+    response_by_date = 'ResponseByDate'
+    resolution_on_date = 'ResolutionOnDate'
+    response_on_time = 'ResponseOnTime'
+    response_on_date = 'ResponseOnDate'
+    closing_time = 'ClosingTime'
+    assigned_date = 'AssignedDate'
+    queue = 'Queue'
+    response_assignee = 'ResponseAssignee'
+    entitledfor_service = 'EntitledforService'
+    resolution_on_time = 'ResolutionOnTime'
+    assigned_time = 'AssignedTime'
+    closing_date = 'ClosingDate'
+    series = 'Series'
+    doc_num = 'DocNum'
+    hand_written = 'HandWritten'
+    period_indicator = 'PeriodIndicator'
+    start_date = 'StartDate'
+    start_time = 'StartTime'
+    end_due_date = 'EndDueDate'
+    end_time = 'EndTime'
+    duration = 'Duration'
+    duration_type = 'DurationType'
+    reminder = 'Reminder'
+    reminder_period = 'ReminderPeriod'
+    reminder_type = 'ReminderType'
+    location = 'Location'
+    address_name = 'AddressName'
+    address_type = 'AddressType'
+    street = 'Street'
+    city = 'City'
+    room = 'Room'
+    state = 'State'
+    country = 'Country'
+    display_in_calendar = 'DisplayInCalendar'
+    customer_ref_no = 'CustomerRefNo'
+    problem_sub_type = 'ProblemSubType'
+    attachment_entry = 'AttachmentEntry'
+    service_bp_type = 'ServiceBPType'
+    bp_contact_person = 'BPContactPerson'
+    bp_phone1 = 'BPPhone1'
+    bp_phone2 = 'BPPhone2'
+    bp_cellular = 'BPCellular'
+    bp_fax = 'BPFax'
+    b_pe_mail = 'BPeMail'
+    bp_project_code = 'BPProjectCode'
+    bp_territory = 'BPTerritory'
+    bp_ship_to_code = 'BPShipToCode'
+    bp_ship_to_address = 'BPShipToAddress'
+    bp_bill_to_code = 'BPBillToCode'
+    bp_bill_to_address = 'BPBillToAddress'
+    telephone = 'Telephone'
+    update_date = 'UpdateDate'
+    supplementary_code = 'SupplementaryCode'
+    service_call_activities = 'ServiceCallActivities'
+    service_call_inventory_expenses = 'ServiceCallInventoryExpenses'
+    service_call_solutions = 'ServiceCallSolutions'
+    service_call_schedulings = 'ServiceCallSchedulings'
+    service_call_bp_address_components = 'ServiceCallBPAddressComponents'
+    business_partner = 'BusinessPartner'
+    service_contract = 'ServiceContract'
+    service_call_origin = 'ServiceCallOrigin'
+    item = 'Item'
+    item_groups = 'ItemGroups'
+    service_call_status = 'ServiceCallStatus'
+    service_call_type = 'ServiceCallType'
+    service_call_problem_type = 'ServiceCallProblemType'
+    user = 'User'
+    employee_info = 'EmployeeInfo'
+    queue2 = 'Queue2'
+    activity_location = 'ActivityLocation'
+    country2 = 'Country2'
+    service_call_problem_sub_type = 'ServiceCallProblemSubType'
+    project = 'Project'
+
+class ServiceCallOriginFields(StrEnum):
+    origin_id = 'OriginID'
+    name = 'Name'
+    description = 'Description'
+    active = 'Active'
+    service_calls = 'ServiceCalls'
+
+class ServiceCallProblemSubTypeFields(StrEnum):
+    problem_sub_type_id = 'ProblemSubTypeID'
+    name = 'Name'
+    description = 'Description'
+    active = 'Active'
+    service_calls = 'ServiceCalls'
+
+class ServiceCallProblemTypeFields(StrEnum):
+    problem_type_id = 'ProblemTypeID'
+    name = 'Name'
+    description = 'Description'
+    active = 'Active'
+    service_calls = 'ServiceCalls'
+
+class ServiceCallSolutionStatusFields(StrEnum):
+    status_id = 'StatusId'
+    name = 'Name'
+    description = 'Description'
+    active = 'Active'
+    knowledge_base_solutions = 'KnowledgeBaseSolutions'
+
+class ServiceCallStatusFields(StrEnum):
+    status_id = 'StatusId'
+    name = 'Name'
+    description = 'Description'
+    active = 'Active'
+    service_calls = 'ServiceCalls'
+
+class ServiceCallTypeFields(StrEnum):
+    call_type_id = 'CallTypeID'
+    name = 'Name'
+    description = 'Description'
+    active = 'Active'
+    service_calls = 'ServiceCalls'

b1sl/b1sl/logging_utils.py

@@ -0,0 +1,119 @@
+import json
+import logging
+import os
+from datetime import datetime, timezone
+
+from b1sl.b1sl.environment import B1Env
+
+
+class B1JSONFormatter(logging.Formatter):
+    """
+    Custom JSON formatter for SAP B1 SDK logs.
+
+    AI Role: Highly recommended for automated log parsing (ELK, Datadog).
+    It structure key metadata into top-level JSON fields for efficient filtering.
+
+    The fields included are:
+        - timestamp (ISO 8601 with Z)
+        - level (LogLevel)
+        - logger (Logger name)
+        - message (Log text)
+        - req_id (Tracing ID)
+        - user (SAP B1 User)
+        - db (Company Database)
+        - session_id (SAP Session)
+        - http_method
+        - endpoint
+        - status_code
+        - sap_error
+    """
+
+    def format(self, record):
+        """
+        Formats a LogRecord into a JSON string.
+
+        Args:
+            record (logging.LogRecord): The log record to format.
+
+        Returns:
+            str: JSON string containing standard and extra fields.
+        """
+        log_record = {
+            "timestamp": datetime.now(timezone.utc).replace(tzinfo=None).isoformat() + "Z",
+            "level": record.levelname,
+            "logger": record.name,
+            "message": record.getMessage(),
+        }
+
+        # Extract structured fields from 'extra' if provided
+        for field in [
+            "req_id",
+            "user",
+            "db",
+            "session_id",
+            "sap_error",
+            "http_method",
+            "endpoint",
+            "status_code",
+        ]:
+            if hasattr(record, field):
+                log_record[field] = getattr(record, field)
+
+        # Include exception info if present
+        if record.exc_info:
+            log_record["exception"] = self.formatException(record.exc_info)
+
+        return json.dumps(log_record)
+
+
+def setup_logging(
+    level: int = logging.INFO,
+    *,
+    env: B1Env | None = None,
+) -> logging.Logger:
+    """
+    Initialise the SAP B1 SDK logger with environment-aware formatting.
+
+    ⚠️ WARNING: FOR STANDALONE SCRIPTS ONLY ⚠️
+    This function configures handlers and formatters on the root "b1sl" logger.
+    If you are using this SDK inside a framework (FastAPI, Django, etc.) that
+    manages its own logging, DO NOT call this function. It will conflict with
+    your host application's handlers. The SDK adheres to standard Python library
+    logging and will naturally propagate to your app's root logger.
+
+    Log format by environment:
+        - ``B1Env.PROD``: Structured JSON via :class:`B1JSONFormatter`.
+        - ``B1Env.DEV`` / ``B1Env.TEST``: Human-readable text.
+
+    Args:
+        level (int, optional): Logging verbosity. Defaults to INFO.
+        env (B1Env, optional): Explicit environment override. When omitted,
+            reads ``B1SL_ENV`` (default: ``dev``).
+
+    Returns:
+        logging.Logger: The configured ``b1sl`` root logger.
+
+    Example::
+
+        env = B1Environment.load()
+        setup_logging(env=env.config.environment)
+    """
+    resolved_env = env or B1Env(os.getenv("B1SL_ENV", "dev").lower())
+
+    logger = logging.getLogger("b1sl")
+    logger.setLevel(level)
+
+    if logger.hasHandlers():
+        logger.handlers.clear()
+
+    handler = logging.StreamHandler()
+
+    if resolved_env == B1Env.PROD:
+        handler.setFormatter(B1JSONFormatter())
+    else:
+        # DEV / TEST: readable and concise
+        formatter = logging.Formatter("%(asctime)s | %(levelname)-8s | %(message)s")
+        handler.setFormatter(formatter)
+
+    logger.addHandler(handler)
+    return logger

b1sl/b1sl/models/__init__.py

@@ -0,0 +1,13 @@
+"""
+b1sl.b1sl.models — public model re-exports.
+
+    from b1sl.b1sl.models import B1Model, PaginatedResult
+"""
+
+from b1sl.b1sl.models.base import B1Model
+from b1sl.b1sl.models.paginated_result import PaginatedResult
+
+__all__ = [
+    "B1Model",
+    "PaginatedResult",
+]

b1sl/b1sl/models/_generated/_types.py

@@ -0,0 +1,5 @@
+# AUTO-GENERATED — do not edit by hand.
+from __future__ import annotations
+from .enums import *
+from .complex_types import *
+from .entities import *