בעיה | הכנסת תוסף לחנות

הלומד

@otzaria-bot פעם כתב לנו:
"אין כרגע benchmark, טלמטריה או התחייבות לזמן ממוצע של storage.set, ולכן אי אפשר לתת מספר אמין במילישניות. הזמן תלוי במערכת ההפעלה, בדיסק, בגודל הערך ובקריאה הראשונה שפותחת את מסד הנתונים.
השמירה עוברת דרך גשר ה־WebView, קידוד JSON, ואז INSERT OR REPLACE למסד SQLite במצב WAL. לכן אובייקט גדול יהיה איטי יותר: הוא מועבר ומקודד בשלמותו ונכתב מחדש כולו. לא מוגדרת כרגע מגבלת גודל ייעודית ל־storage, אבל לא מומלץ להשתמש בו לנתונים גדולים מאוד. המימוש נמצא ב־plugin_bridge_adapter.dart (שורה 1876) וב־plugin_system_database.dart (שורה 301).
אין כרגע API מסוג storage.setMany או batch. האפשרויות הן:

לבצע מספר קריאות נפרדות — הן אינן אטומיות וכל אחת נספרת במגבלת קצב הקריאות.
לשמור אובייקט אחד המכיל כמה ערכים תחת מפתח יחיד. זו קריאה אחת וכתיבה אחת, למשל:

await Otzaria.call('storage.set', {
  key: 'state',
  value: {
    settings,
    progress,
    cacheMetadata
  }
});

אין גם אירוע Otzaria ייעודי ואמין כמו beforeunload לפני יציאת האפליקציה או סגירת התוסף. קיימים plugin.suspended ו־plugin.resumed, אבל plugin.suspended נורה כאשר עוזבים את לשונית התוסף, לא כאירוע shutdown. בסגירת האפליקציה ה־WebViews מפונים ישירות דרך plugin_runtime_dispatcher.dart (שורה 218).
ייתכן שאירוע DOM כמו beforeunload יופעל בחלק מהתרחישים, אבל זו אינה הבטחה של ה־SDK ואי אפשר לסמוך עליו להשלמת קריאת RPC אסינכרונית. ההמלצה היא לשמור בזמן שהנתונים משתנים, עם debounce, ולא להמתין ליציאה. אפשר לבצע שמירה נוספת ב־plugin.suspended כ־best effort בלבד."

השתמשנו בplugin.suspended ו־plugin.resumed בדרך הזו:

Otzaria.on('plugin.suspended', callback);
Otzaria.on('plugin.resumed', callback);

וקבלנו את השגיאה הזו:

איך נרשמים נכון לplugin.suspended ו־plugin.resumed?

מצורפים הקבצים שבהם כתוב שיש רישום לevent
access-lock.js
reminders.js
storage-io.js

י. פל.

@otzaria-bot
תענה בבקשה, קרא את הקוד הרלוונטי.
(אם הוא לא יענה, שלח לי צ'אט עוד כמה שעות).

הלומד

@י.-פל.

לפי השעה כנראה מחר, אין בעיה

י. פל.

הוא לא עונה, כי נגמרו הטוקנים...

י. פל.

@otzaria-bot
קרא את ההודעה הראשונה בשרשור, והגב.

Otzaria-Bot

@הלומד — הרישום שלכם נכון. השגיאה שקיבלתם אינה שגיאת ריצה אלא ולידציה של החנות בהעלאה.

איך זה עובד בפועל

plugin.suspended ו-plugin.resumed נשלחים ישירות כ-CustomEvent על window מתוך plugin_runtime_dispatcher.dart (השהיה) ו-שורה 168 (חזרה), וה-dispatch עצמו בשורה 193. מצד ה-SDK, Otzaria.on(event, cb) הוא בסך הכל עטיפה ל-window.addEventListener (plugin_tab_page.dart שורה 712) — בלי בדיקת שם אירוע ובלי בדיקת הרשאה.

מכאן שני דברים:

Otzaria.on('plugin.suspended', cb) היא הצורה הנכונה, והיא עובדת.
אין הרשאת events.subscribe:plugin.suspended ואין צורך בה — אירועי lifecycle אינם עוברים דרך בדיקת ההרשאות של dispatchEvent. אל תוסיפו אותה ל-manifest, היא תיפסל כהרשאה לא חוקית.

למה החנות בכל זאת חסמה

הוולידטור של החנות בונה את רשימת האירועים המוכרים מתוך docs/plugin-sdk/API_REFERENCE.md — הוא שולף שמות מדוגמאות Otzaria.on('...') ומהרשאות events.subscribe:X שמופיעות שם. plugin.suspended ו-plugin.resumed מתועדים כרגע רק ב-otzaria_plugin.d.ts (שורות 588-590) ולא ב-API_REFERENCE, ולכן הם יוצאים "לא מוכרים". ובהעלאה לחנות כל warning חוסם, לא רק error. זהו פספוס בתיעוד/ולידטור, לא בקוד שלכם.

עקיפה שעובדת עכשיו

הסורק מחפש רק Otzaria.on( / Otzaria.off(. לכן:

window.addEventListener('plugin.suspended', () => stopReminderInterval());
window.addEventListener('plugin.resumed', () => startReminderInterval());

זהה לחלוטין מבחינת התנהגות (זה מה ש-Otzaria.on עושה מתחת), ועובר את הולידציה. שימו לב שכאן ה-callback מקבל את אובייקט ה-Event, כך שאם תצטרכו payload באירוע אחר — e.detail. ב-lifecycle ה-detail הוא null בכל מקרה.

ובהזדמנות זו: plugin.suspended נורה גם ביציאה מלשונית התוסף, לא רק בסגירת האפליקציה, ולכן הוא כן שימושי כ-flush נקודתי — אבל אין להסתמך עליו כאירוע shutdown.

התיקון האמיתי הוא להוסיף את שני האירועים ל-API_REFERENCE.md (ולרשימת ה-fallback בוולידטור). @י.-פל.

כדי שזה לא ייעלם — פתחו issue: https://github.com/Otzaria/otzaria/issues

י. פל.

@Otzaria-Bot כתב:

זהו פספוס בתיעוד/ולידטור, לא בקוד שלכם.

@פלמנמוני

הלומד

@י.-פל. כתב:

@פלמנמוני

לחכות לו או לעשות את הפתרון הזמני שהוא אמר?

הפתרון שהם הציעו: במקום Otzaria.on(...) לכתוב window.addEventListener(...) — זה בדיוק אותו דבר מאחורי הקלעים, רק שהולידטור לא סורק את זה.

תוצאה: הקוד עובד זהה, השגיאה בחנות נעלמת.

הלומד

ראיתי שזה מתעכב אז שמתי את "הפלסטר" שהביא לי הרובוט
@י.-פל. @יאיר-דניאל לא יודע מי המנהל שרשום שם שצריך לאשר אני אשמח שזה יקרה

@פלמנמוני כדאי בכל מקרה לסדר את זה שזה לא יקרה גם לבאים אחרי

י. פל.

@הלומד
תזכר אותי עוד כמה שעות - א׳ החברים כאן תרם לי מנוי קודקס מורחב (עולה 100$!!!), ואני מתכנן שיפוץ לאתר, לטקסטים ולמהירות הטעינה, על הדרך אתקן גם את זה בע״ה.
אם למישהו יש בעיות נוספות עם האתר (למשל - דף התרומות לא עובד!!!!), אנא פתח שרשור, וכתוב בו את כל הבעיות - אשמח לעבוד בצורה מרוכזת, גם ככה אני על 3-4 repo's במקביל...

הלומד

@י.-פל. כתב:

תזכר אותי עוד כמה שעות

בלי נדר אני מתחבר חזרה רק ב10 בערב בערך

י. פל.

בטיפול.

הלומד

@י.-פל. כתב:

תזכר אותי עוד כמה שעות

תזכור

פורום אוצריא

בעיה | הכנסת תוסף לחנות