@flowdular/sdk 0.2.4 → 0.3.1

package/modules/import/translations/en.json

@@ -0,0 +1,175 @@
+{
+	"navigation.label": "Imports",
+	"navigation.description": "Bring records into this workspace from a CSV file.",
+	"page.eyebrow": "Operations",
+	"page.title": "Imports",
+	"page.description": "Every import runs as a job: the file is parsed, every row is validated, and only then are records written.",
+	"denied": "You do not have permission to read import jobs in this workspace.",
+	"common.accessDenied": "Access denied",
+	"common.actions": "Actions",
+	"common.close": "Close",
+	"common.filters": "Filters",
+	"common.messages": "Messages",
+	"common.no": "No",
+	"common.pending": "Not finished",
+	"common.refresh": "Refresh",
+	"common.refreshing": "Refreshing…",
+	"common.yes": "Yes",
+	"table.title": "Import jobs",
+	"table.caption": "Import jobs in this workspace",
+	"table.count": "{count} jobs",
+	"table.loading": "Loading import jobs…",
+	"table.note": "A job only ever writes through the target module, under the permissions you hold.",
+	"empty.title": "No imports yet",
+	"empty.hint": "Start an import to bring records in from a CSV file.",
+	"emptyFiltered.title": "No job matches",
+	"emptyFiltered.hint": "Clear the filters to see every import job.",
+	"column.target": "Target",
+	"column.status": "Status",
+	"column.mode": "Mode",
+	"column.dryRun": "Dry run",
+	"column.totalRows": "Rows",
+	"column.validRows": "Valid",
+	"column.writtenRows": "Written",
+	"column.failedRows": "Failed",
+	"column.startedAt": "Started",
+	"column.completedAt": "Finished",
+	"column.documentId": "Document",
+	"filter.status": "Status",
+	"filter.allStatuses": "Every status",
+	"filter.target": "Target",
+	"filter.allTargets": "Every target",
+	"status.parsing": "Parsing",
+	"status.validated": "Validated",
+	"status.writing": "Writing",
+	"status.completed": "Completed",
+	"status.failed": "Failed",
+	"status.cancelled": "Cancelled",
+	"mode.create-only": "Create only",
+	"mode.update-existing": "Update existing",
+	"mode.skip-existing": "Skip existing",
+	"outcome.valid": "Valid",
+	"outcome.invalid": "Invalid",
+	"outcome.created": "Created",
+	"outcome.updated": "Updated",
+	"outcome.skipped": "Skipped",
+	"outcome.failed": "Failed",
+	"type.string": "Text",
+	"type.integer": "Whole number",
+	"type.boolean": "Yes or no",
+	"type.date": "Date",
+	"type.email": "E-mail address",
+	"action.new": "New import",
+	"action.open": "Open",
+	"action.continue": "Write the rows",
+	"action.cancel": "Cancel the job",
+	"job.title": "Import job",
+	"job.loading": "Loading the job",
+	"job.loadingHint": "The job and its row outcomes are on their way.",
+	"job.totalRows": "Rows",
+	"job.validRows": "Valid",
+	"job.writtenRows": "Written",
+	"job.failedRows": "Failed",
+	"job.failureCode": "Failure",
+	"job.decide": "This job is validated",
+	"job.decideClean": "Every row passed validation. Writing sends them to the target module.",
+	"job.decideMixed": "{valid} of {total} rows passed. Writing sends the valid rows only; the rest stay listed below.",
+	"rows.caption": "Row outcomes for this job",
+	"rows.loading": "Loading rows…",
+	"rows.loadMore": "Load more rows",
+	"rows.empty.title": "No rows yet",
+	"rows.empty.hint": "Row outcomes appear once the file has been parsed.",
+	"rows.column.row": "Row",
+	"rows.column.outcome": "Outcome",
+	"rows.column.field": "Field",
+	"rows.column.reason": "Reason",
+	"rows.column.recordRef": "Record",
+	"form.title": "New import",
+	"form.subtitle": "Choose a target, upload the CSV and map its columns.",
+	"form.target": "Target",
+	"form.targetPlaceholder": "Choose a target",
+	"form.targetDenied": "{label} (no permission)",
+	"form.mode": "Mode",
+	"form.file": "CSV file",
+	"form.fileHelp": "UTF-8 with a header row, up to 25 MB.",
+	"form.mapping": "Column mapping",
+	"form.mappingHelp": "Columns detected in {file}.",
+	"form.mappingManual": "The header could not be read, so type the column names.",
+	"form.columnNone": "Not imported",
+	"form.fieldType": "Expects: {type}",
+	"form.dryRun": "Dry run",
+	"form.dryRunHelp": "Validate every row and write nothing.",
+	"form.saveMapping": "Save the mapping",
+	"form.saveMappingHelp": "Offer this mapping the next time you import into this target.",
+	"form.note": "The file is stored through Documents; nothing is written until validation has run.",
+	"form.cancel": "Cancel",
+	"form.submit": "Start the import",
+	"form.submitting": "Starting…",
+	"form.error.tooLarge": "That file is larger than 25 MB.",
+	"form.error.mapping": "The required field {field} has no column.",
+	"cancel.title": "Cancel this import?",
+	"cancel.description": "The job stops before anything is written. The file stays in Documents.",
+	"notice.started": "Import into {target} started.",
+	"notice.continued": "The valid rows are being written.",
+	"notice.cancelled": "The import was cancelled.",
+	"error.request": "The request failed.",
+	"error.load": "The import jobs could not be loaded.",
+	"error.start": "The import could not be started.",
+	"error.continue": "The job could not be continued.",
+	"error.cancel": "The job could not be cancelled.",
+	"error.code.TARGET_UNKNOWN": "No module offers that import target.",
+	"error.code.TARGET_FORBIDDEN": "You do not hold the permission this target requires.",
+	"error.code.MODE_UNKNOWN": "That import mode is not one this module offers.",
+	"error.code.MAPPING_INCOMPLETE": "A required field has no column in the mapping.",
+	"error.code.MAPPING_UNKNOWN_FIELD": "The mapping names a field this target does not accept.",
+	"error.code.MAPPING_COLUMN_MISSING": "The file has no column for a mapped field.",
+	"error.code.MAPPING_COLUMN_REUSED": "The mapping points two fields at one column.",
+	"error.code.MAPPING_TOO_LARGE": "The column mapping is larger than an import job can record.",
+	"error.code.REQUESTER_TOO_LARGE": "Your account carries more grants than an import job can record.",
+	"error.code.SOURCE_NOT_FOUND": "The source document is not stored in this workspace.",
+	"error.code.SOURCE_NOT_CSV": "The source document is not a CSV file.",
+	"error.code.SOURCE_TOO_LARGE": "The source document is larger than 25 MB.",
+	"error.code.SOURCE_INFECTED": "The source document was refused by the malware scanner.",
+	"error.code.DOCUMENTS_UNAVAILABLE": "Documents is not available, so the file cannot be read.",
+	"error.code.JOB_NOT_FOUND": "That import job does not exist in this workspace.",
+	"error.code.JOB_NOT_VALIDATED": "Only a validated job can be continued or cancelled.",
+	"error.code.JOB_DRY_RUN": "A dry run writes nothing; start a new job to write these rows.",
+	"error.code.VALIDATION_FAILED": "This job has invalid rows; continue with the valid rows only.",
+	"error.code.CLAIM_LOST": "Another process took this import job over while it was running.",
+	"error.code.IMPORT_PORTS_SEALED": "Import targets are registered while the platform starts.",
+	"error.code.IMPORT_PORT_INVALID": "A module declared an import target this platform cannot accept.",
+	"error.code.IMPORT_PORT_DUPLICATE": "Two modules declared the same import target.",
+	"error.code.CSV_EMPTY": "The file carries no header row.",
+	"error.code.CSV_NOT_UTF8": "The file is not valid UTF-8 text.",
+	"error.code.CSV_TOO_LARGE": "The file is larger than 25 MB.",
+	"error.code.CSV_TOO_MANY_ROWS": "The file holds more rows than one job may carry.",
+	"error.code.CSV_HEADER_BLANK": "A column header in the file is blank.",
+	"error.code.CSV_HEADER_DUPLICATE": "A column header appears more than once.",
+	"error.code.CSV_QUOTE_UNTERMINATED": "A quoted field in the file is never closed.",
+	"error.code.CSV_QUOTE_UNEXPECTED": "A quote in the file is in a place this reader cannot interpret.",
+	"reason.ROW_RAGGED": "This row has a different number of cells than the header.",
+	"reason.FIELD_REQUIRED": "This required field is empty.",
+	"reason.FIELD_TYPE": "This value is not the type the field expects.",
+	"reason.NATURAL_KEY_DUPLICATE": "An earlier row of this file already carries this key.",
+	"reason.PORT_FAILED": "The target module refused this batch.",
+	"reason.PORT_SILENT": "The target module reported no outcome for this row.",
+	"reason.JOB_FAILED": "The job stopped on an unexpected error.",
+	"reason.CSV_EMPTY": "The file carries no header row.",
+	"reason.CSV_NOT_UTF8": "The file is not valid UTF-8 text.",
+	"reason.CSV_TOO_LARGE": "The file is larger than 25 MB.",
+	"reason.CSV_TOO_MANY_ROWS": "The file holds more rows than one job may carry.",
+	"reason.CSV_HEADER_BLANK": "A column header in the file is blank.",
+	"reason.CSV_HEADER_DUPLICATE": "A column header appears more than once.",
+	"reason.CSV_QUOTE_UNTERMINATED": "A quoted field in the file is never closed.",
+	"reason.CSV_QUOTE_UNEXPECTED": "A quote in the file is in a place this reader cannot interpret.",
+	"reason.MAPPING_COLUMN_MISSING": "The file has no column for a mapped field.",
+	"reason.SOURCE_NOT_FOUND": "The source document is not stored in this workspace.",
+	"reason.SOURCE_NOT_CSV": "The source document is not a CSV file.",
+	"reason.SOURCE_TOO_LARGE": "The source document is larger than 25 MB.",
+	"reason.SOURCE_INFECTED": "The source document was refused by the malware scanner.",
+	"reason.DOCUMENTS_UNAVAILABLE": "Documents is not available, so the file cannot be read.",
+	"settings.maxRows.label": "Rows per job",
+	"settings.maxRows.description": "Rows one import job may hold; a larger file is refused.",
+	"settings.batchSize.label": "Rows per batch",
+	"settings.batchSize.description": "Rows handed to an import port in one validate or write call."
+}

package/modules/import/translations/pl.json

@@ -0,0 +1,175 @@
+{
+	"navigation.label": "Importy",
+	"navigation.description": "Wczytaj rekordy do tego obszaru roboczego z pliku CSV.",
+	"page.eyebrow": "Operacje",
+	"page.title": "Importy",
+	"page.description": "Każdy import to zadanie: plik jest przetwarzany, każdy wiersz sprawdzany i dopiero wtedy rekordy są zapisywane.",
+	"denied": "Nie masz uprawnień do odczytu zadań importu w tym obszarze roboczym.",
+	"common.accessDenied": "Brak dostępu",
+	"common.actions": "Akcje",
+	"common.close": "Zamknij",
+	"common.filters": "Filtry",
+	"common.messages": "Komunikaty",
+	"common.no": "Nie",
+	"common.pending": "Niezakończone",
+	"common.refresh": "Odśwież",
+	"common.refreshing": "Odświeżanie…",
+	"common.yes": "Tak",
+	"table.title": "Zadania importu",
+	"table.caption": "Zadania importu w tym obszarze roboczym",
+	"table.count": "Zadania: {count}",
+	"table.loading": "Wczytywanie zadań importu…",
+	"table.note": "Zadanie zapisuje wyłącznie przez moduł docelowy, w granicach Twoich uprawnień.",
+	"empty.title": "Brak importów",
+	"empty.hint": "Rozpocznij import, aby wczytać rekordy z pliku CSV.",
+	"emptyFiltered.title": "Brak pasujących zadań",
+	"emptyFiltered.hint": "Wyczyść filtry, aby zobaczyć wszystkie zadania importu.",
+	"column.target": "Cel",
+	"column.status": "Status",
+	"column.mode": "Tryb",
+	"column.dryRun": "Próba",
+	"column.totalRows": "Wiersze",
+	"column.validRows": "Poprawne",
+	"column.writtenRows": "Zapisane",
+	"column.failedRows": "Błędne",
+	"column.startedAt": "Rozpoczęto",
+	"column.completedAt": "Zakończono",
+	"column.documentId": "Dokument",
+	"filter.status": "Status",
+	"filter.allStatuses": "Wszystkie statusy",
+	"filter.target": "Cel",
+	"filter.allTargets": "Wszystkie cele",
+	"status.parsing": "Przetwarzanie",
+	"status.validated": "Sprawdzone",
+	"status.writing": "Zapisywanie",
+	"status.completed": "Zakończone",
+	"status.failed": "Nieudane",
+	"status.cancelled": "Anulowane",
+	"mode.create-only": "Tylko tworzenie",
+	"mode.update-existing": "Aktualizuj istniejące",
+	"mode.skip-existing": "Pomiń istniejące",
+	"outcome.valid": "Poprawny",
+	"outcome.invalid": "Niepoprawny",
+	"outcome.created": "Utworzony",
+	"outcome.updated": "Zaktualizowany",
+	"outcome.skipped": "Pominięty",
+	"outcome.failed": "Nieudany",
+	"type.string": "Tekst",
+	"type.integer": "Liczba całkowita",
+	"type.boolean": "Tak lub nie",
+	"type.date": "Data",
+	"type.email": "Adres e-mail",
+	"action.new": "Nowy import",
+	"action.open": "Otwórz",
+	"action.continue": "Zapisz wiersze",
+	"action.cancel": "Anuluj zadanie",
+	"job.title": "Zadanie importu",
+	"job.loading": "Wczytywanie zadania",
+	"job.loadingHint": "Zadanie i wyniki wierszy są w drodze.",
+	"job.totalRows": "Wiersze",
+	"job.validRows": "Poprawne",
+	"job.writtenRows": "Zapisane",
+	"job.failedRows": "Błędne",
+	"job.failureCode": "Błąd",
+	"job.decide": "To zadanie jest sprawdzone",
+	"job.decideClean": "Wszystkie wiersze przeszły walidację. Zapis wyśle je do modułu docelowego.",
+	"job.decideMixed": "Poprawnych wierszy: {valid} z {total}. Zapis obejmie tylko poprawne, reszta pozostanie na liście poniżej.",
+	"rows.caption": "Wyniki wierszy tego zadania",
+	"rows.loading": "Wczytywanie wierszy…",
+	"rows.loadMore": "Wczytaj kolejne wiersze",
+	"rows.empty.title": "Brak wierszy",
+	"rows.empty.hint": "Wyniki wierszy pojawią się po przetworzeniu pliku.",
+	"rows.column.row": "Wiersz",
+	"rows.column.outcome": "Wynik",
+	"rows.column.field": "Pole",
+	"rows.column.reason": "Powód",
+	"rows.column.recordRef": "Rekord",
+	"form.title": "Nowy import",
+	"form.subtitle": "Wybierz cel, wgraj plik CSV i przypisz jego kolumny.",
+	"form.target": "Cel",
+	"form.targetPlaceholder": "Wybierz cel",
+	"form.targetDenied": "{label} (brak uprawnień)",
+	"form.mode": "Tryb",
+	"form.file": "Plik CSV",
+	"form.fileHelp": "UTF-8 z wierszem nagłówka, do 25 MB.",
+	"form.mapping": "Przypisanie kolumn",
+	"form.mappingHelp": "Kolumny wykryte w pliku {file}.",
+	"form.mappingManual": "Nie udało się odczytać nagłówka, wpisz nazwy kolumn.",
+	"form.columnNone": "Nie importowane",
+	"form.fieldType": "Oczekiwany typ: {type}",
+	"form.dryRun": "Próba",
+	"form.dryRunHelp": "Sprawdź każdy wiersz i nie zapisuj niczego.",
+	"form.saveMapping": "Zapisz przypisanie",
+	"form.saveMappingHelp": "Zaproponuj to przypisanie przy następnym imporcie do tego celu.",
+	"form.note": "Plik jest przechowywany przez moduł Dokumenty; nic nie zostanie zapisane przed walidacją.",
+	"form.cancel": "Anuluj",
+	"form.submit": "Rozpocznij import",
+	"form.submitting": "Rozpoczynanie…",
+	"form.error.tooLarge": "Ten plik jest większy niż 25 MB.",
+	"form.error.mapping": "Wymagane pole {field} nie ma przypisanej kolumny.",
+	"cancel.title": "Anulować ten import?",
+	"cancel.description": "Zadanie zatrzyma się przed zapisem. Plik pozostanie w Dokumentach.",
+	"notice.started": "Import do celu {target} został rozpoczęty.",
+	"notice.continued": "Poprawne wiersze są zapisywane.",
+	"notice.cancelled": "Import został anulowany.",
+	"error.request": "Żądanie nie powiodło się.",
+	"error.load": "Nie udało się wczytać zadań importu.",
+	"error.start": "Nie udało się rozpocząć importu.",
+	"error.continue": "Nie udało się kontynuować zadania.",
+	"error.cancel": "Nie udało się anulować zadania.",
+	"error.code.TARGET_UNKNOWN": "Żaden moduł nie udostępnia tego celu importu.",
+	"error.code.TARGET_FORBIDDEN": "Nie masz uprawnienia wymaganego przez ten cel.",
+	"error.code.MODE_UNKNOWN": "Ten tryb importu nie jest obsługiwany przez ten moduł.",
+	"error.code.MAPPING_INCOMPLETE": "Wymagane pole nie ma przypisanej kolumny.",
+	"error.code.MAPPING_UNKNOWN_FIELD": "Przypisanie wskazuje pole, którego ten cel nie przyjmuje.",
+	"error.code.MAPPING_COLUMN_MISSING": "Plik nie zawiera kolumny dla przypisanego pola.",
+	"error.code.MAPPING_COLUMN_REUSED": "Przypisanie wskazuje dwa pola na jedną kolumnę.",
+	"error.code.MAPPING_TOO_LARGE": "Przypisanie kolumn jest większe, niż zadanie importu może zapisać.",
+	"error.code.REQUESTER_TOO_LARGE": "Twoje konto ma więcej uprawnień, niż zadanie importu może zapisać.",
+	"error.code.SOURCE_NOT_FOUND": "Dokument źródłowy nie istnieje w tym obszarze roboczym.",
+	"error.code.SOURCE_NOT_CSV": "Dokument źródłowy nie jest plikiem CSV.",
+	"error.code.SOURCE_TOO_LARGE": "Dokument źródłowy jest większy niż 25 MB.",
+	"error.code.SOURCE_INFECTED": "Dokument źródłowy został odrzucony przez skaner antywirusowy.",
+	"error.code.DOCUMENTS_UNAVAILABLE": "Moduł Dokumenty jest niedostępny, więc pliku nie można odczytać.",
+	"error.code.JOB_NOT_FOUND": "To zadanie importu nie istnieje w tym obszarze roboczym.",
+	"error.code.JOB_NOT_VALIDATED": "Kontynuować lub anulować można tylko sprawdzone zadanie.",
+	"error.code.JOB_DRY_RUN": "Próba nic nie zapisuje; rozpocznij nowe zadanie, aby zapisać te wiersze.",
+	"error.code.VALIDATION_FAILED": "To zadanie ma niepoprawne wiersze; kontynuuj tylko z poprawnymi.",
+	"error.code.CLAIM_LOST": "Inny proces przejął to zadanie importu w trakcie jego wykonywania.",
+	"error.code.IMPORT_PORTS_SEALED": "Cele importu są rejestrowane podczas uruchamiania platformy.",
+	"error.code.IMPORT_PORT_INVALID": "Moduł zadeklarował cel importu, którego platforma nie przyjmuje.",
+	"error.code.IMPORT_PORT_DUPLICATE": "Dwa moduły zadeklarowały ten sam cel importu.",
+	"error.code.CSV_EMPTY": "Plik nie zawiera wiersza nagłówka.",
+	"error.code.CSV_NOT_UTF8": "Plik nie jest poprawnym tekstem UTF-8.",
+	"error.code.CSV_TOO_LARGE": "Plik jest większy niż 25 MB.",
+	"error.code.CSV_TOO_MANY_ROWS": "Plik zawiera więcej wierszy, niż może objąć jedno zadanie.",
+	"error.code.CSV_HEADER_BLANK": "Nagłówek kolumny w pliku jest pusty.",
+	"error.code.CSV_HEADER_DUPLICATE": "Nagłówek kolumny powtarza się.",
+	"error.code.CSV_QUOTE_UNTERMINATED": "Pole w cudzysłowie nie zostało zamknięte.",
+	"error.code.CSV_QUOTE_UNEXPECTED": "Cudzysłów znajduje się w miejscu, którego czytnik nie potrafi zinterpretować.",
+	"reason.ROW_RAGGED": "Ten wiersz ma inną liczbę komórek niż nagłówek.",
+	"reason.FIELD_REQUIRED": "To wymagane pole jest puste.",
+	"reason.FIELD_TYPE": "Ta wartość nie jest typem oczekiwanym przez pole.",
+	"reason.NATURAL_KEY_DUPLICATE": "Wcześniejszy wiersz tego pliku ma już ten klucz.",
+	"reason.PORT_FAILED": "Moduł docelowy odrzucił tę partię.",
+	"reason.PORT_SILENT": "Moduł docelowy nie zgłosił wyniku dla tego wiersza.",
+	"reason.JOB_FAILED": "Zadanie zatrzymało się na nieoczekiwanym błędzie.",
+	"reason.CSV_EMPTY": "Plik nie zawiera wiersza nagłówka.",
+	"reason.CSV_NOT_UTF8": "Plik nie jest poprawnym tekstem UTF-8.",
+	"reason.CSV_TOO_LARGE": "Plik jest większy niż 25 MB.",
+	"reason.CSV_TOO_MANY_ROWS": "Plik zawiera więcej wierszy, niż może objąć jedno zadanie.",
+	"reason.CSV_HEADER_BLANK": "Nagłówek kolumny w pliku jest pusty.",
+	"reason.CSV_HEADER_DUPLICATE": "Nagłówek kolumny powtarza się.",
+	"reason.CSV_QUOTE_UNTERMINATED": "Pole w cudzysłowie nie zostało zamknięte.",
+	"reason.CSV_QUOTE_UNEXPECTED": "Cudzysłów znajduje się w miejscu, którego czytnik nie potrafi zinterpretować.",
+	"reason.MAPPING_COLUMN_MISSING": "Plik nie zawiera kolumny dla przypisanego pola.",
+	"reason.SOURCE_NOT_FOUND": "Dokument źródłowy nie istnieje w tym obszarze roboczym.",
+	"reason.SOURCE_NOT_CSV": "Dokument źródłowy nie jest plikiem CSV.",
+	"reason.SOURCE_TOO_LARGE": "Dokument źródłowy jest większy niż 25 MB.",
+	"reason.SOURCE_INFECTED": "Dokument źródłowy został odrzucony przez skaner antywirusowy.",
+	"reason.DOCUMENTS_UNAVAILABLE": "Moduł Dokumenty jest niedostępny, więc pliku nie można odczytać.",
+	"settings.maxRows.label": "Wiersze na zadanie",
+	"settings.maxRows.description": "Liczba wierszy, jaką może objąć jedno zadanie importu; większy plik zostanie odrzucony.",
+	"settings.batchSize.label": "Wiersze na partię",
+	"settings.batchSize.description": "Liczba wierszy przekazywana portowi importu w jednym wywołaniu walidacji lub zapisu."
+}

package/modules/metering/migrations/0001_metering_core.down.sql

@@ -0,0 +1,6 @@
+DROP TABLE IF EXISTS metering_threshold_notices;
+DROP TABLE IF EXISTS metering_limit_events;
+DROP TABLE IF EXISTS metering_limits;
+DROP TABLE IF EXISTS metering_records;
+DROP TABLE IF EXISTS metering_buckets;
+DROP TABLE IF EXISTS metering_meters;

package/modules/metering/migrations/0001_metering_core.up.sql

@@ -0,0 +1,119 @@
+-- Meters as one workspace recorded them. The declaration itself lives in the
+-- composed process; a row appears the first time a module reports a fact for
+-- this workspace, which is what makes the registry readable under the tenant
+-- policy like every other row metering.core owns.
+CREATE TABLE IF NOT EXISTS metering_meters (
+  id TEXT PRIMARY KEY,
+  tenant_id TEXT NOT NULL,
+  meter_key TEXT NOT NULL CHECK (length(meter_key) BETWEEN 1 AND 96),
+  module_id TEXT NOT NULL CHECK (length(module_id) BETWEEN 1 AND 64),
+  label TEXT NOT NULL CHECK (length(label) BETWEEN 1 AND 120),
+  unit TEXT NOT NULL CHECK (length(unit) BETWEEN 1 AND 32),
+  kind TEXT NOT NULL CHECK (kind IN ('cumulative', 'gauge')),
+  created_at BIGINT NOT NULL,
+  UNIQUE (tenant_id, meter_key)
+);
+ALTER TABLE metering_meters ENABLE ROW LEVEL SECURITY;
+ALTER TABLE metering_meters FORCE ROW LEVEL SECURITY;
+CREATE POLICY metering_meters_tenant_policy ON metering_meters
+  USING (tenant_id = current_setting('coreloom.tenant_id', true))
+  WITH CHECK (tenant_id = current_setting('coreloom.tenant_id', true));
+
+-- One row per meter per UTC day. The unique key is also the index every read
+-- and every accumulating write uses, so a fact costs one upsert and a month
+-- total is a range scan over ordered days.
+CREATE TABLE IF NOT EXISTS metering_buckets (
+  id TEXT PRIMARY KEY,
+  tenant_id TEXT NOT NULL,
+  meter_key TEXT NOT NULL CHECK (length(meter_key) BETWEEN 1 AND 96),
+  day TEXT NOT NULL CHECK (length(day) = 10),
+  amount BIGINT NOT NULL CHECK (amount >= 0),
+  events BIGINT NOT NULL CHECK (events >= 0),
+  updated_at BIGINT NOT NULL,
+  UNIQUE (tenant_id, meter_key, day)
+);
+CREATE INDEX IF NOT EXISTS metering_buckets_tenant_day_idx
+  ON metering_buckets (tenant_id, day, meter_key);
+ALTER TABLE metering_buckets ENABLE ROW LEVEL SECURITY;
+ALTER TABLE metering_buckets FORCE ROW LEVEL SECURITY;
+CREATE POLICY metering_buckets_tenant_policy ON metering_buckets
+  USING (tenant_id = current_setting('coreloom.tenant_id', true))
+  WITH CHECK (tenant_id = current_setting('coreloom.tenant_id', true));
+
+-- What makes a fact idempotent. The unique key is the whole mechanism: a
+-- repeat of a source reference inserts nothing and the bucket is left alone.
+-- The day column is carried so a retention sweep of the bucket class removes
+-- these rows on the same cutoff and the same index.
+CREATE TABLE IF NOT EXISTS metering_records (
+  id TEXT PRIMARY KEY,
+  tenant_id TEXT NOT NULL,
+  meter_key TEXT NOT NULL CHECK (length(meter_key) BETWEEN 1 AND 96),
+  source_ref TEXT NOT NULL CHECK (length(source_ref) BETWEEN 1 AND 200),
+  day TEXT NOT NULL CHECK (length(day) = 10),
+  amount BIGINT NOT NULL CHECK (amount >= 0),
+  recorded_at BIGINT NOT NULL,
+  UNIQUE (tenant_id, meter_key, source_ref)
+);
+CREATE INDEX IF NOT EXISTS metering_records_tenant_day_idx
+  ON metering_records (tenant_id, day, id);
+ALTER TABLE metering_records ENABLE ROW LEVEL SECURITY;
+ALTER TABLE metering_records FORCE ROW LEVEL SECURITY;
+CREATE POLICY metering_records_tenant_policy ON metering_records
+  USING (tenant_id = current_setting('coreloom.tenant_id', true))
+  WITH CHECK (tenant_id = current_setting('coreloom.tenant_id', true));
+
+-- The operator's ceiling. No foreign key to metering_meters: a limit is set
+-- before the workspace has reported its first fact for that meter, which is
+-- the point of setting one.
+CREATE TABLE IF NOT EXISTS metering_limits (
+  id TEXT PRIMARY KEY,
+  tenant_id TEXT NOT NULL,
+  meter_key TEXT NOT NULL CHECK (length(meter_key) BETWEEN 1 AND 96),
+  monthly_limit BIGINT NOT NULL CHECK (monthly_limit >= 0),
+  set_by TEXT NOT NULL CHECK (length(set_by) BETWEEN 1 AND 128),
+  updated_at BIGINT NOT NULL,
+  UNIQUE (tenant_id, meter_key)
+);
+ALTER TABLE metering_limits ENABLE ROW LEVEL SECURITY;
+ALTER TABLE metering_limits FORCE ROW LEVEL SECURITY;
+CREATE POLICY metering_limits_tenant_policy ON metering_limits
+  USING (tenant_id = current_setting('coreloom.tenant_id', true))
+  WITH CHECK (tenant_id = current_setting('coreloom.tenant_id', true));
+
+-- Every limit the operator set, in order, with the label the CLI derived. The
+-- limit row carries the current value; this is the evidence of how it got
+-- there and it is never rewritten.
+CREATE TABLE IF NOT EXISTS metering_limit_events (
+  id TEXT PRIMARY KEY,
+  tenant_id TEXT NOT NULL,
+  meter_key TEXT NOT NULL CHECK (length(meter_key) BETWEEN 1 AND 96),
+  monthly_limit BIGINT NOT NULL CHECK (monthly_limit >= 0),
+  previous_limit BIGINT CHECK (previous_limit IS NULL OR previous_limit >= 0),
+  set_by TEXT NOT NULL CHECK (length(set_by) BETWEEN 1 AND 128),
+  occurred_at BIGINT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS metering_limit_events_tenant_occurred_idx
+  ON metering_limit_events (tenant_id, occurred_at DESC, id);
+ALTER TABLE metering_limit_events ENABLE ROW LEVEL SECURITY;
+ALTER TABLE metering_limit_events FORCE ROW LEVEL SECURITY;
+CREATE POLICY metering_limit_events_tenant_policy ON metering_limit_events
+  USING (tenant_id = current_setting('coreloom.tenant_id', true))
+  WITH CHECK (tenant_id = current_setting('coreloom.tenant_id', true));
+
+-- One row per meter per month per threshold. The unique key is what makes a
+-- threshold notification happen once: the row is claimed inside the recording
+-- transaction and only a claim that inserted publishes.
+CREATE TABLE IF NOT EXISTS metering_threshold_notices (
+  id TEXT PRIMARY KEY,
+  tenant_id TEXT NOT NULL,
+  meter_key TEXT NOT NULL CHECK (length(meter_key) BETWEEN 1 AND 96),
+  month TEXT NOT NULL CHECK (length(month) = 7),
+  threshold TEXT NOT NULL CHECK (threshold IN ('warning', 'exhausted')),
+  sent_at BIGINT NOT NULL,
+  UNIQUE (tenant_id, meter_key, month, threshold)
+);
+ALTER TABLE metering_threshold_notices ENABLE ROW LEVEL SECURITY;
+ALTER TABLE metering_threshold_notices FORCE ROW LEVEL SECURITY;
+CREATE POLICY metering_threshold_notices_tenant_policy ON metering_threshold_notices
+  USING (tenant_id = current_setting('coreloom.tenant_id', true))
+  WITH CHECK (tenant_id = current_setting('coreloom.tenant_id', true));

package/modules/metering/migrations/0002_metering_bucket_export.down.sql

@@ -0,0 +1,3 @@
+-- Reverses 0002: the export walk falls back to a scan of the workspace's
+-- buckets per page, which is correct but unindexed.
+DROP INDEX IF EXISTS metering_buckets_tenant_export_idx;

package/modules/metering/migrations/0002_metering_bucket_export.up.sql

@@ -0,0 +1,5 @@
+-- The data class export walks a workspace's buckets by id, ascending. The
+-- retention index leads with the day, so it cannot serve that walk and a large
+-- workspace paged through a sequential scan per page.
+CREATE INDEX IF NOT EXISTS metering_buckets_tenant_export_idx
+  ON metering_buckets (tenant_id, id);

package/modules/metering/migrations/README.md

@@ -0,0 +1,3 @@
+# Migrations
+
+Migrations in this directory are append-only after release.

package/modules/metering/module.json

@@ -0,0 +1,46 @@
+{
+	"$schema": "../../packages/contracts/schemas/module.schema.json",
+	"schemaVersion": 1,
+	"id": "metering.core",
+	"package": "@flowdular/module-metering",
+	"version": "0.1.7",
+	"platformApi": "^0.1.0",
+	"profile": "full",
+	"capabilities": ["api", "database", "client", "translations", "cli"],
+	"platform": {
+		"server": true,
+		"client": true
+	},
+	"dependencies": [
+		{
+			"id": "system.core",
+			"range": "^0.7.0"
+		},
+		{
+			"id": "auth.core",
+			"range": "^0.13.0"
+		},
+		{
+			"id": "reports.core",
+			"range": "^0.1.0"
+		}
+	],
+	"provides": ["metering.meters.v1"],
+	"requires": [
+		{
+			"id": "notifications.publish.v1",
+			"optional": true
+		},
+		{
+			"id": "reports.v1",
+			"optional": true
+		}
+	],
+	"tenancy": "required",
+	"locales": ["en", "pl"],
+	"stability": "experimental",
+	"cli": {
+		"catalog": "src/cli/commands.json",
+		"entry": "src/cli/index.ts"
+	}
+}

package/modules/metering/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "@flowdular/module-metering",
+	"version": "0.1.7",
+	"private": true,
+	"type": "module",
+	"exports": {
+		".": "./src/index.ts",
+		"./client": "./src/client/index.ts",
+		"./server": "./src/server/index.ts",
+		"./platform": "./src/platform.ts",
+		"./module.json": "./module.json"
+	},
+	"files": [
+		"src",
+		"schemas",
+		"dist",
+		"bin",
+		"public",
+		"module.json",
+		"migrations",
+		"translations",
+		"spec",
+		"README.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"typecheck": "tsrx-tsc --noEmit -p tsconfig.json",
+		"test": "vitest run"
+	},
+	"dependencies": {
+		"@flowdular/cli-protocol": "workspace:*",
+		"@flowdular/client": "workspace:*",
+		"@flowdular/contracts": "workspace:*",
+		"@flowdular/database": "workspace:*",
+		"@flowdular/kernel": "workspace:*",
+		"@flowdular/module-auth": "workspace:*",
+		"@flowdular/module-reports": "workspace:*",
+		"@flowdular/server": "workspace:*",
+		"@flowdular/ui": "workspace:*",
+		"octane": "0.1.51",
+		"segment-state": "0.2.1"
+	},
+	"devDependencies": {
+		"@flowdular/database-testing": "workspace:*",
+		"@tsrx/typescript-plugin": "0.3.120",
+		"@types/node": "24.13.3",
+		"typescript": "5.9.3",
+		"vitest": "4.1.11"
+	}
+}