contextbase-plugin-reminders-local 0.2.6__py3-none-any.whl

contextbase_plugin_reminders_local-0.2.6.dist-info/METADATA

@@ -0,0 +1,13 @@
+Metadata-Version: 2.3
+Name: contextbase-plugin-reminders-local
+Version: 0.2.6
+Summary: Apple Reminders local plugin for ContextBase
+Author: Alizain Feerasta
+Author-email: Alizain Feerasta <alizain.feerasta@gmail.com>
+Requires-Dist: contextbase-shared-plugins==0.2.6
+Requires-Dist: dagster==1.12.14
+Requires-Dist: dagster-dlt==0.28.14
+Requires-Dist: dlt>=1.26.0
+Requires-Dist: pydantic>=2.12.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Python: >=3.14, <3.15

contextbase_plugin_reminders_local-0.2.6.dist-info/RECORD

@@ -0,0 +1,16 @@
+plugin_reminders_local/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_reminders_local/binding_config.py,sha256=YBgQFhcTujAPYs94JeSJAgyCMQfTVj_aAbfVfoKMTjM,488
+plugin_reminders_local/component.py,sha256=Mldw0sLSJ2aZD2pNj_yFsGuO2_ZCreuLJCUz7hlaIFw,3817
+plugin_reminders_local/defs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_reminders_local/defs/defs.yaml,sha256=UJHl2J8qyF0WMEqRXdw8yoocNEWLZWHxRGAP00W8rbE,67
+plugin_reminders_local/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_reminders_local/models/base.py,sha256=Fp7n4EfxQOxzqm34-D-rYyu60P88eZUIewCBNP_Iuc4,119
+plugin_reminders_local/models/ctx.py,sha256=HwkxlYl3jcHtIq-EyrkNYpm-elGJ7N4IvkPD7Tm_t7o,14456
+plugin_reminders_local/models/ingress.py,sha256=hB6vGyc0MRGT41igYdoD_XrmB9murM-Nk8JZHUj4TgY,31515
+plugin_reminders_local/models/translators.py,sha256=d784hsQAKynd2klgdXVj1wJlybbXrQOqufbRPtTJBrI,27815
+plugin_reminders_local/plugin.json,sha256=AsvjcdjaWFh-LBANQ8d0lqGkmYToA7Ccp_wj_M83lc0,88
+plugin_reminders_local/sources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plugin_reminders_local/sources/snapshot.py,sha256=k1rrBaVQXaiPPMHZZH7lpBIpWZAKUmkGwJ-v_gVvYU0,15492
+contextbase_plugin_reminders_local-0.2.6.dist-info/WHEEL,sha256=i9aSRDivn5iP9LaR1BLQX2GNAuriQWPsFwbbWygTX2k,81
+contextbase_plugin_reminders_local-0.2.6.dist-info/METADATA,sha256=qAL8DZgyjuTf4DfbvyKKzGYsDScCY1bdFGkEDUWFdc8,457
+contextbase_plugin_reminders_local-0.2.6.dist-info/RECORD,,

contextbase_plugin_reminders_local-0.2.6.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.15
+Root-Is-Purelib: true
+Tag: py3-none-any

plugin_reminders_local/binding_config.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from pydantic import Field
+
+from shared_plugins.bindings import BaseBindingConfigModel, ResolvedPath
+
+
+class RemindersLocalBindingConfig(BaseBindingConfigModel):
+    stores_dir: ResolvedPath = Field(
+        default_factory=lambda: (
+            Path.home()
+            / "Library"
+            / "Group Containers"
+            / "group.com.apple.reminders"
+            / "Container_v1"
+            / "Stores"
+        ),
+    )

plugin_reminders_local/component.py

@@ -0,0 +1,113 @@
+import dagster as dg
+from dagster import AssetExecutionContext
+from dagster_dlt import DagsterDltResource
+from shared_plugins.automation import non_overlapping_automation_condition
+from shared_plugins.bindings import parse_binding_config
+from shared_plugins.control_plane import ControlPlaneClient
+from shared_plugins.dlt import resolve_partition_binding, run_dlt_pipeline
+from shared_plugins.naming import (
+    dagster_asset_group_name,
+    dagster_asset_tags,
+    dagster_dlt_asset_key,
+    dagster_partition_def_name,
+    dagster_pool_name,
+    dlt_source_name,
+    plugin_id_from_module,
+)
+from shared_plugins.resources import DLT_RESOURCE
+
+from .binding_config import RemindersLocalBindingConfig
+from .sources.snapshot import reminders_local_snapshot_source
+
+PLUGIN_ID = plugin_id_from_module(__file__)
+SNAPSHOT_JOB = "snapshot"
+
+_SNAPSHOT_RESOURCE_NAMES = (
+    "list",
+    "reminder",
+    "hashtag_label",
+    "saved_attachment",
+    "alarm",
+    "shared_with",
+    "hashtag_join",
+    "recurrence_rule",
+    "attachment_entity",
+)
+
+
+def _build_snapshot_specs(
+    partitions_def: dg.PartitionsDefinition,
+    automation_condition: dg.AutomationCondition,
+) -> list[dg.AssetSpec]:
+    snapshot_source_name = dlt_source_name(PLUGIN_ID, SNAPSHOT_JOB)
+    shared = dict(
+        group_name=dagster_asset_group_name(PLUGIN_ID),
+        tags=dagster_asset_tags(PLUGIN_ID),
+        automation_condition=automation_condition,
+        partitions_def=partitions_def,
+    )
+    return [
+        dg.AssetSpec(
+            key=dagster_dlt_asset_key(snapshot_source_name, resource_name),
+            **shared,
+        )
+        for resource_name in _SNAPSHOT_RESOURCE_NAMES
+    ]
+
+
+class RemindersLocalSyncComponent(dg.Component):
+    def build_defs(self, context: dg.ComponentLoadContext) -> dg.Definitions:
+        partitions_def = dg.DynamicPartitionsDefinition(
+            name=dagster_partition_def_name(PLUGIN_ID)
+        )
+        snapshot_specs = _build_snapshot_specs(
+            partitions_def=partitions_def,
+            automation_condition=non_overlapping_automation_condition(
+                dg.AutomationCondition.on_missing()
+                | dg.AutomationCondition.on_cron("*/15 * * * *")
+            ),
+        )
+
+        @dg.multi_asset(
+            specs=snapshot_specs,
+            can_subset=True,
+            name="reminders_local_snapshot",
+            pool=dagster_pool_name(PLUGIN_ID),
+        )
+        def reminders_local_snapshot_assets(
+            context: AssetExecutionContext,
+            dlt_resource: DagsterDltResource,
+            control_plane: dg.ResourceParam[ControlPlaneClient],
+        ):
+            binding = resolve_partition_binding(
+                context=context,
+                control_plane=control_plane,
+                plugin_id=PLUGIN_ID,
+            )
+            binding_id = str(binding.binding_id)
+            cfg = parse_binding_config(binding, RemindersLocalBindingConfig)
+
+            source = reminders_local_snapshot_source(binding_id, cfg)
+            yield from run_dlt_pipeline(
+                context=context,
+                dlt_resource=dlt_resource,
+                source=source,
+                plugin_id=PLUGIN_ID,
+                binding_id=binding_id,
+                job_name=SNAPSHOT_JOB,
+            )
+
+        automation_sensor = dg.AutomationConditionSensorDefinition(
+            name="reminders_local_automation_sensor",
+            target=dg.AssetSelection.assets(reminders_local_snapshot_assets),
+            default_status=dg.DefaultSensorStatus.RUNNING,
+            minimum_interval_seconds=30,
+        )
+
+        return dg.Definitions(
+            assets=[reminders_local_snapshot_assets],
+            sensors=[automation_sensor],
+            resources={
+                "dlt_resource": DLT_RESOURCE,
+            },
+        )

plugin_reminders_local/defs/defs.yaml

@@ -0,0 +1 @@
+type: plugin_reminders_local.component.RemindersLocalSyncComponent

plugin_reminders_local/models/base.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from sqlalchemy.orm import DeclarativeBase
+
+
+class Base(DeclarativeBase):
+    pass

plugin_reminders_local/models/ctx.py

@@ -0,0 +1,377 @@
+"""Pydantic CtxModels emitted by the Reminders plugin resources.
+
+Shape mirrors the ingress ORM 1:1 for maximum source fidelity.
+Operational/cached ``_ctx_*`` metadata is added by the CtxModel base.
+
+Every ctx row carries ``store_guid`` — the Apple account-store UUID
+(from the ``Data-<UUID>.sqlite`` filename). Multiple stores coexist
+under one binding; ``store_guid`` tells you which account produced
+the row.
+
+Source primary keys use Apple UUIDs (``ck_identifier`` VARCHAR form)
+which are globally unique across accounts, so ``store_guid`` is
+provenance, not disambiguation.
+
+Rows derived from the ``ZREMCDOBJECT`` polymorphic table are split into
+narrow ctx models per ``Z_ENT`` (Alarm/Sharee/HashtagJoin/RecurrenceRule/
+AttachmentEntity) — a single fat ingress row becomes one typed ctx row
+matching its semantic entity.
+"""
+
+from __future__ import annotations
+
+from pydantic import AwareDatetime
+from shared_plugins.models import CtxModel
+
+
+class ListRow(CtxModel):
+    """From ZREMCDBASELIST. Regular lists (Z_ENT=3) and smart lists (Z_ENT=4)."""
+
+    store_guid: str
+    pk: int
+    ent: int | None = None
+    opt: int | None = None
+    guid: str  # = ck_identifier, the CloudKit UUID
+    identifier: bytes | None = None  # raw 16-byte UUID form
+    name: str | None = None
+    smart_list_type: str | None = None
+    sorting_style: str | None = None
+    badge_emblem: str | None = None
+    color: bytes | None = None  # bplist NSColor
+    filter_data: bytes | None = None  # smart-list predicate
+    account: int | None = None
+    parent_account: int | None = None
+    parent_list: int | None = None
+    parent_account1: int | None = None
+    parent_list1: int | None = None
+    is_group: int | None = None
+    is_pinned_by_current_user: int | None = None
+    sharing_status: int | None = None
+    should_categorize_grocery_items: int | None = None
+    should_suggest_conversion_to_grocery_list: int | None = None
+    showing_large_attachments: int | None = None
+    spotlight_index_count: int | None = None
+    da_display_order: int | None = None
+    da_is_event_only_container: int | None = None
+    da_is_immutable: int | None = None
+    da_is_notifications_collection: int | None = None
+    da_is_read_only: int | None = None
+    da_external_identification_tag: str | None = None
+    da_bulk_requests: bytes | None = None
+    marked_for_deletion: int | None = None
+    ck_dirty_flags: int | None = None
+    ck_cloud_state: int | None = None
+    ck_needs_initial_fetch_from_cloud: int | None = None
+    ck_needs_to_be_fetched_from_cloud: int | None = None
+    ck_zone_owner_name: str | None = None
+    ck_server_record_data: bytes | None = None
+    ck_server_share_data: bytes | None = None
+    shared_owner_address: str | None = None
+    shared_owner_name: str | None = None
+    shared_owner_identifier: bytes | None = None
+    pinned_date: AwareDatetime | None = None
+    last_user_access_date: AwareDatetime | None = None
+    external_identifier: str | None = None
+    external_modification_tag: str | None = None
+    da_push_key: str | None = None
+    da_sync_token: str | None = None
+    effective_minimum_supported_app_version: int | None = None
+    minimum_supported_app_version: int | None = None
+    memberships_of_reminders_in_sections_checksum: str | None = None
+    memberships_of_reminders_in_sections_as_data: bytes | None = None
+    resolution_token_map: bytes | None = None
+    resolution_token_map_v2_json: bytes | None = None
+    resolution_token_map_v3_json_data: bytes | None = None
+    section_ids_ordering_as_data: bytes | None = None
+    grocery_local_corrections_checksum: str | None = None
+    grocery_locale_id: str | None = None
+    grocery_local_corrections_as_data: bytes | None = None
+    most_recent_target_template_identifier: bytes | None = None
+    most_recent_target_template_identifier_by_current_user: bytes | None = None
+    reminder_ids_mergeable_ordering: bytes | None = None
+    reminder_ids_mergeable_ordering_v2_json: bytes | None = None
+    fok_parent_list: int | None = None
+    fok_parent_account: int | None = None
+    fok_parent_list1: int | None = None
+    fok_parent_account1: int | None = None
+
+
+class ReminderRow(CtxModel):
+    """From ZREMCDREMINDER. One row per reminder (incl. subtasks)."""
+
+    store_guid: str
+    pk: int
+    ent: int | None = None
+    opt: int | None = None
+    guid: str  # = ck_identifier
+    identifier: bytes | None = None
+    title: str | None = None
+    notes: str | None = None
+    notes_document: bytes | None = None  # gzipped NSAttributedString
+    title_document: bytes | None = None  # gzipped NSAttributedString
+    priority: int | None = None
+    flagged: int | None = None
+    completed: int | None = None
+    completion_date: AwareDatetime | None = None
+    creation_date: AwareDatetime | None = None
+    last_modified_date: AwareDatetime | None = None
+    due_date: AwareDatetime | None = None
+    display_date_date: AwareDatetime | None = None
+    display_date_is_all_day: int | None = None
+    display_date_timezone: str | None = None
+    display_date_updated_for_seconds_from_gmt: int | None = None
+    alternative_display_date_date_for_calendar: AwareDatetime | None = None
+    start_date: AwareDatetime | None = None
+    all_day: int | None = None
+    timezone: str | None = None
+    last_banner_presentation_date: AwareDatetime | None = None
+    list_pk: int | None = None
+    list_guid: str | None = None  # resolved from ZLIST via list_lookup
+    parent_reminder_pk: int | None = None
+    parent_reminder_guid: str | None = (
+        None  # resolved; also ck_parent_reminder_identifier
+    )
+    ck_parent_reminder_identifier: str | None = None
+    account: int | None = None
+    ics_display_order: int | None = None
+    ics_url: str | None = None
+    imported_ics_data: bytes | None = None
+    da_calendar_item_unique_identifier: str | None = None
+    shared_to_me_reminder_placeholder: int | None = None
+    z15_reminders: int | None = None
+    fok_list: int | None = None
+    marked_for_deletion: int | None = None
+    ck_dirty_flags: int | None = None
+    ck_cloud_state: int | None = None
+    ck_needs_initial_fetch_from_cloud: int | None = None
+    ck_needs_to_be_fetched_from_cloud: int | None = None
+    ck_zone_owner_name: str | None = None
+    ck_server_record_data: bytes | None = None
+    ck_server_share_data: bytes | None = None
+    contact_handles: bytes | None = None
+    due_date_delta_alerts_data: bytes | None = None
+    siri_found_in_apps_data: bytes | None = None
+    user_activity: bytes | None = None
+    external_identifier: str | None = None
+    external_modification_tag: str | None = None
+    da_push_key: str | None = None
+    da_sync_token: str | None = None
+    effective_minimum_supported_app_version: int | None = None
+    minimum_supported_app_version: int | None = None
+    resolution_token_map: bytes | None = None
+    resolution_token_map_v2_json: bytes | None = None
+    resolution_token_map_v3_json_data: bytes | None = None
+    spotlight_index_count: int | None = None
+
+
+class HashtagLabelRow(CtxModel):
+    """From ZREMCDHASHTAGLABEL. Tag vocabulary."""
+
+    store_guid: str
+    pk: int
+    ent: int | None = None
+    opt: int | None = None
+    name: str | None = None
+    canonical_name: str | None = None
+    account_identifier: str | None = None
+    first_occurrence_creation_date: AwareDatetime | None = None
+    recency_date: AwareDatetime | None = None
+    uuid_for_change_tracking: bytes | None = None
+
+
+class SavedAttachmentRow(CtxModel):
+    """From ZREMCDSAVEDATTACHMENT. File-attachment metadata (content lives in filesystem)."""
+
+    store_guid: str
+    pk: int
+    ent: int | None = None
+    opt: int | None = None
+    guid: str  # = ck_identifier
+    identifier: bytes | None = None
+    reminder_pk: int | None = None
+    reminder_guid: str | None = None  # resolved via reminder_lookup
+    filename: str | None = None
+    uti: str | None = None
+    attachment_type_raw_value: str | None = None
+    sha512_sum: str | None = None
+    metadata_blob: bytes | None = None  # bplist dict
+    last_modified_date: AwareDatetime | None = None
+    account: int | None = None
+    marked_for_deletion: int | None = None
+    ck_dirty_flags: int | None = None
+    ck_cloud_state: int | None = None
+    ck_needs_initial_fetch_from_cloud: int | None = None
+    ck_needs_to_be_fetched_from_cloud: int | None = None
+    ck_zone_owner_name: str | None = None
+    ck_server_record_data: bytes | None = None
+    ck_server_share_data: bytes | None = None
+    external_identifier: str | None = None
+    external_modification_tag: str | None = None
+    da_push_key: str | None = None
+    da_sync_token: str | None = None
+    effective_minimum_supported_app_version: int | None = None
+    minimum_supported_app_version: int | None = None
+    resolution_token_map: bytes | None = None
+    resolution_token_map_v2_json: bytes | None = None
+    resolution_token_map_v3_json_data: bytes | None = None
+
+
+class AlarmRow(CtxModel):
+    """From ZREMCDOBJECT where Z_ENT=16 (REMCDAlarm). Flattens the linked
+    trigger row (Z_ENT=18 date / 19 location / 20 time-interval) into
+    ``trigger_*`` fields so consumers see one row per alarm with the
+    trigger semantics inlined.
+    """
+
+    store_guid: str
+    pk: int
+    ent: int  # = 16
+    opt: int | None = None
+    guid: str  # alarm ck_identifier
+    identifier: bytes | None = None
+    reminder_pk: int | None = None
+    reminder_guid: str | None = None
+    trigger_pk: int | None = None
+    z17_trigger_pk: int | None = None
+    acknowledged_date: AwareDatetime | None = None
+    alarm_uid: str | None = None
+    original_alarm_uid: str | None = None
+    is_extraneous: int | None = None
+    due_date_resolution_token_as_nonce: float | None = None
+    # Inlined from trigger row
+    trigger_ent: int | None = None  # 18, 19, 20
+    trigger_type: str | None = None  # 'date' | 'location' | 'time_interval'
+    trigger_guid: str | None = None
+    trigger_identifier: bytes | None = None
+    # Date trigger (ent=18)
+    trigger_date_components_data: bytes | None = None  # JSON NSDateComponents
+    # Location trigger (ent=19)
+    trigger_latitude: float | None = None
+    trigger_longitude: float | None = None
+    trigger_radius: float | None = None
+    trigger_proximity: int | None = None
+    trigger_address: str | None = None
+    trigger_contact_label: str | None = None
+    trigger_location_uid: str | None = None
+    trigger_reference_frame_string: str | None = None
+    trigger_routing: str | None = None
+    trigger_title: str | None = None
+    trigger_mapkit_handle: bytes | None = None
+    # Time interval trigger (ent=20)
+    trigger_time_interval: float | None = None
+    # CK / sync
+    account: int | None = None
+    marked_for_deletion: int | None = None
+    ck_dirty_flags: int | None = None
+    ck_cloud_state: int | None = None
+    ck_server_record_data: bytes | None = None
+
+
+class SharedWithRow(CtxModel):
+    """From ZREMCDOBJECT where Z_ENT=37 (REMCDSharee)."""
+
+    store_guid: str
+    pk: int
+    ent: int  # = 37
+    opt: int | None = None
+    guid: str  # = ck_identifier
+    identifier: bytes | None = None
+    list_pk: int | None = None
+    list_guid: str | None = None
+    access_level: int | None = None
+    status1: int | None = None
+    first_name: str | None = None
+    last_name: str | None = None
+    middle_name: str | None = None
+    name_prefix: str | None = None
+    name_suffix: str | None = None
+    nickname: str | None = None
+    display_name: str | None = None
+    address1: str | None = None
+    account: int | None = None
+    marked_for_deletion: int | None = None
+    ck_dirty_flags: int | None = None
+    ck_cloud_state: int | None = None
+
+
+class HashtagJoinRow(CtxModel):
+    """From ZREMCDOBJECT where Z_ENT=33 (REMCDHashtag). Joins a reminder
+    to a label (from ZREMCDHASHTAGLABEL). 0 rows in the probed DB — shape
+    inferred from schema only.
+    """
+
+    store_guid: str
+    pk: int
+    ent: int  # = 33
+    opt: int | None = None
+    guid: str
+    identifier: bytes | None = None
+    hashtag_label_pk: int | None = None
+    hashtag_label_name: str | None = None  # resolved via hashtag_label_lookup
+    reminder_pk: int | None = None  # via reminder3_pk/reminder4_pk/reminder5_pk
+    reminder_guid: str | None = None
+    account: int | None = None
+    marked_for_deletion: int | None = None
+    ck_dirty_flags: int | None = None
+    ck_cloud_state: int | None = None
+
+
+class RecurrenceRuleRow(CtxModel):
+    """From ZREMCDOBJECT where Z_ENT=35 (REMCDRecurrenceRule). 0 rows in
+    the probed DB — shape inferred from schema only."""
+
+    store_guid: str
+    pk: int
+    ent: int  # = 35
+    opt: int | None = None
+    guid: str
+    identifier: bytes | None = None
+    reminder_pk: int | None = None
+    reminder_guid: str | None = None
+    frequency: int | None = None
+    interval: int | None = None
+    first_day_of_the_week: int | None = None
+    occurrence_count: int | None = None
+    end_date: AwareDatetime | None = None
+    days_of_the_week: bytes | None = None
+    days_of_the_month: bytes | None = None
+    days_of_the_year: bytes | None = None
+    months_of_the_year: bytes | None = None
+    weeks_of_the_year: bytes | None = None
+    set_positions: bytes | None = None
+    account: int | None = None
+    marked_for_deletion: int | None = None
+    ck_dirty_flags: int | None = None
+    ck_cloud_state: int | None = None
+
+
+class AttachmentEntityRow(CtxModel):
+    """From ZREMCDOBJECT where Z_ENT in (24,25,26,27) — File/Audio/Image/URL
+    attachment subtypes unified into one resource with ``attachment_type``
+    discriminator. 0 rows in probed DB — shape inferred from schema.
+    """
+
+    store_guid: str
+    pk: int
+    ent: int  # 24/25/26/27
+    attachment_type: str  # 'file' | 'audio' | 'image' | 'url'
+    opt: int | None = None
+    guid: str
+    identifier: bytes | None = None
+    reminder_pk: int | None = None
+    reminder_guid: str | None = None
+    filename: str | None = None
+    uti: str | None = None
+    file_size: int | None = None
+    height: int | None = None
+    width: int | None = None
+    length: float | None = None  # audio duration
+    sha512_sum: str | None = None
+    transcribed_text: str | None = None
+    url: str | None = None
+    host_url: str | None = None
+    metadata_blob: bytes | None = None
+    account: int | None = None
+    marked_for_deletion: int | None = None
+    ck_dirty_flags: int | None = None
+    ck_cloud_state: int | None = None