@ferricstore/ferricstore 0.5.1 → 0.11.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (131) hide show
  1. package/README.md +44 -5
  2. package/dist/index.cjs +2162 -518
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.d.cts +183 -34
  5. package/dist/index.d.ts +183 -34
  6. package/dist/index.js +2134 -490
  7. package/dist/index.js.map +1 -1
  8. package/docs/api/assets/hierarchy.js +1 -1
  9. package/docs/api/assets/navigation.js +1 -1
  10. package/docs/api/assets/search.js +1 -1
  11. package/docs/api/classes/ConnectionClosedError.html +1 -1
  12. package/docs/api/classes/FerricStoreClient.html +3 -3
  13. package/docs/api/classes/FerricStoreError.html +1 -1
  14. package/docs/api/classes/FlowAlreadyExistsError.html +1 -1
  15. package/docs/api/classes/FlowBatchError.html +1 -1
  16. package/docs/api/classes/FlowNotFoundError.html +1 -1
  17. package/docs/api/classes/FlowQueryError.html +1 -1
  18. package/docs/api/classes/FlowWrongStateError.html +1 -1
  19. package/docs/api/classes/InvalidCommandError.html +1 -1
  20. package/docs/api/classes/LeaseRenewalError.html +1 -1
  21. package/docs/api/classes/LockHeldError.html +1 -1
  22. package/docs/api/classes/LockNotOwnedError.html +1 -1
  23. package/docs/api/classes/NativeAdapter.html +1 -1
  24. package/docs/api/classes/OverloadedError.html +1 -1
  25. package/docs/api/classes/QueueCompletionError.html +1 -1
  26. package/docs/api/classes/RequestTimeoutError.html +1 -1
  27. package/docs/api/classes/RerouteError.html +1 -1
  28. package/docs/api/classes/StaleLeaseError.html +1 -1
  29. package/docs/api/classes/StalePolicyGenerationError.html +1 -1
  30. package/docs/api/functions/projectFlowQuery.html +1 -1
  31. package/docs/api/hierarchy.html +1 -1
  32. package/docs/api/index.html +34 -5
  33. package/docs/api/interfaces/AdminListOptions.html +2 -2
  34. package/docs/api/interfaces/ApprovalListOptions.html +2 -2
  35. package/docs/api/interfaces/ApprovalRequestOptions.html +2 -2
  36. package/docs/api/interfaces/AttributeQueryOptions.html +2 -2
  37. package/docs/api/interfaces/AutoBatchOptions.html +2 -2
  38. package/docs/api/interfaces/BudgetCommitOptions.html +2 -2
  39. package/docs/api/interfaces/BudgetReserveOptions.html +2 -2
  40. package/docs/api/interfaces/CancelOptions.html +2 -2
  41. package/docs/api/interfaces/CircuitOpenOptions.html +2 -2
  42. package/docs/api/interfaces/ClaimDueOptions.html +3 -3
  43. package/docs/api/interfaces/ClaimHydrationItem.html +2 -2
  44. package/docs/api/interfaces/CompleteJobsAndClaimJobsResult.html +6 -6
  45. package/docs/api/interfaces/CompleteManyOptions.html +2 -2
  46. package/docs/api/interfaces/CompleteOptions.html +2 -2
  47. package/docs/api/interfaces/CompleteOutcome.html +1 -1
  48. package/docs/api/interfaces/CreateManyOptions.html +5 -5
  49. package/docs/api/interfaces/CreateOptions.html +3 -3
  50. package/docs/api/interfaces/EffectCompensateOptions.html +2 -2
  51. package/docs/api/interfaces/EffectConfirmOptions.html +2 -2
  52. package/docs/api/interfaces/EffectFailOptions.html +2 -2
  53. package/docs/api/interfaces/EffectReserveOptions.html +2 -2
  54. package/docs/api/interfaces/EffectStatusOptions.html +2 -2
  55. package/docs/api/interfaces/ExtendLeaseOptions.html +2 -2
  56. package/docs/api/interfaces/FailOptions.html +2 -2
  57. package/docs/api/interfaces/FailOutcome.html +1 -1
  58. package/docs/api/interfaces/FerricStoreClientFromUrlOptions.html +4 -4
  59. package/docs/api/interfaces/FerricStoreClientOptions.html +4 -4
  60. package/docs/api/interfaces/FlowBatchCompletedItem.html +2 -2
  61. package/docs/api/interfaces/FlowEventProjectionField.html +2 -2
  62. package/docs/api/interfaces/FlowExplainCapabilities.html +5 -0
  63. package/docs/api/interfaces/FlowExplainResult.html +8 -2
  64. package/docs/api/interfaces/FlowPolicyOptions.html +5 -5
  65. package/docs/api/interfaces/FlowQueryCountResult.html +1 -1
  66. package/docs/api/interfaces/FlowQueryIndex.html +11 -2
  67. package/docs/api/interfaces/FlowQueryIndexBuild.html +10 -0
  68. package/docs/api/interfaces/FlowQueryIndexCoverage.html +5 -0
  69. package/docs/api/interfaces/FlowQueryIndexField.html +5 -0
  70. package/docs/api/interfaces/FlowQueryIndexFormat.html +2 -2
  71. package/docs/api/interfaces/FlowQueryIndexProgress.html +7 -0
  72. package/docs/api/interfaces/FlowQueryIndexRegistry.html +2 -2
  73. package/docs/api/interfaces/FlowQueryIndexRetirement.html +10 -0
  74. package/docs/api/interfaces/FlowQueryIndexServices.html +6 -0
  75. package/docs/api/interfaces/FlowQueryIndexStatistics.html +11 -0
  76. package/docs/api/interfaces/FlowQueryIndexStatus.html +2 -2
  77. package/docs/api/interfaces/FlowQueryIndexValidation.html +13 -0
  78. package/docs/api/interfaces/FlowQueryQuality.html +2 -2
  79. package/docs/api/interfaces/FlowQueryRecordsResult.html +1 -1
  80. package/docs/api/interfaces/FlowRunProjectionField.html +2 -2
  81. package/docs/api/interfaces/FlowStatePolicy.html +2 -2
  82. package/docs/api/interfaces/FlowStatsOptions.html +2 -2
  83. package/docs/api/interfaces/GovernanceLedgerOptions.html +2 -2
  84. package/docs/api/interfaces/HistoryOptions.html +2 -2
  85. package/docs/api/interfaces/InvocationCreateOptions.html +2 -2
  86. package/docs/api/interfaces/LeaseMutationOptions.html +2 -2
  87. package/docs/api/interfaces/LimitAmountOptions.html +2 -2
  88. package/docs/api/interfaces/LimitLeaseOptions.html +2 -2
  89. package/docs/api/interfaces/LimitListOptions.html +2 -2
  90. package/docs/api/interfaces/LimitReleaseOptions.html +2 -2
  91. package/docs/api/interfaces/MutateOptions.html +2 -2
  92. package/docs/api/interfaces/NamedValueMutation.html +1 -1
  93. package/docs/api/interfaces/ReadOptions.html +3 -3
  94. package/docs/api/interfaces/ReclaimOptions.html +2 -2
  95. package/docs/api/interfaces/RequestContext.html +2 -2
  96. package/docs/api/interfaces/RequestContextOptions.html +2 -2
  97. package/docs/api/interfaces/RetryOptions.html +2 -2
  98. package/docs/api/interfaces/RetryOutcome.html +1 -1
  99. package/docs/api/interfaces/RunStepsItem.html +2 -2
  100. package/docs/api/interfaces/RunStepsManyOptions.html +2 -2
  101. package/docs/api/interfaces/ScheduleFireDueOptions.html +3 -2
  102. package/docs/api/interfaces/ScheduleFireOptions.html +3 -0
  103. package/docs/api/interfaces/ScheduleListOptions.html +2 -2
  104. package/docs/api/interfaces/ScheduleOptions.html +4 -2
  105. package/docs/api/interfaces/SearchOptions.html +3 -3
  106. package/docs/api/interfaces/StartAndClaimOptions.html +3 -3
  107. package/docs/api/interfaces/StepContinueOptions.html +3 -3
  108. package/docs/api/interfaces/TDigestCreateOptions.html +1 -1
  109. package/docs/api/interfaces/TDigestMergeOptions.html +1 -1
  110. package/docs/api/interfaces/TransitionOptions.html +2 -2
  111. package/docs/api/interfaces/TransitionOutcome.html +1 -1
  112. package/docs/api/modules.html +1 -1
  113. package/docs/api/types/ConnectionRequestDisposition.html +1 -1
  114. package/docs/api/types/FlowProjectionField.html +1 -1
  115. package/docs/api/types/FlowProjectionShape.html +1 -1
  116. package/docs/api/types/FlowQueryIndexServiceState.html +1 -0
  117. package/docs/api/types/FlowStateMode.html +1 -1
  118. package/docs/api/types/FlowStatePolicyLike.html +1 -1
  119. package/docs/api/types/ManagementPairs.html +1 -1
  120. package/docs/api/types/ScheduleCatchupPolicy.html +2 -0
  121. package/docs/api/types/ScheduleFireDueResult.html +3 -0
  122. package/docs/api/types/ScheduleFireResult.html +2 -0
  123. package/docs/api/types/ScheduleKind.html +1 -0
  124. package/docs/api/types/ScheduleOverlapPolicy.html +1 -0
  125. package/docs/api/types/ScheduleRecord.html +12 -0
  126. package/docs/api/types/ScheduleState.html +1 -0
  127. package/docs/api/types/SearchStateMeta.html +1 -1
  128. package/docs/api/variables/FERRICSTORE_MINIMUM_SERVER_VERSION.html +1 -1
  129. package/docs/api/variables/FERRICSTORE_SDK_VERSION.html +1 -1
  130. package/docs/api/variables/FlowProjection.html +1 -1
  131. package/package.json +2 -2
package/dist/index.d.cts CHANGED
@@ -681,6 +681,63 @@ interface FlowRecord<TPayload = unknown> {
681
681
  }
682
682
 
683
683
  type FlowAdminRecord = Record<string, unknown>;
684
+ /** Bounded interval recovery; missed occurrences are coalesced into one fire. */
685
+ type ScheduleCatchupPolicy = "fire_once";
686
+ type ScheduleKind = "one_shot" | "delay" | "interval" | "cron";
687
+ type ScheduleState = "active" | "paused" | "running" | "completed" | "failed" | "cancelled";
688
+ type ScheduleOverlapPolicy = "allow" | "skip" | "queue_after_previous" | "fail_schedule";
689
+ /** Canonical durable schedule returned by create, get, pause, resume, and list. */
690
+ type ScheduleRecord = FlowAdminRecord & {
691
+ id: string;
692
+ kind: ScheduleKind;
693
+ state: ScheduleState;
694
+ target: Record<string, unknown>;
695
+ created_at_ms: number;
696
+ /** Interval period, or `null` for non-interval schedules. */
697
+ every_ms: number | null;
698
+ /** Cron expression, or `null` for non-cron schedules. */
699
+ cron: string | null;
700
+ /** IANA timezone, or `null` for non-cron schedules. */
701
+ timezone: string | null;
702
+ /** `fire_once` for interval schedules and `null` for other kinds. */
703
+ catchup_policy: ScheduleCatchupPolicy | null;
704
+ /** Cumulative elapsed interval occurrences intentionally not replayed. */
705
+ coalesced_count: number;
706
+ /** Wall-clock recovery time of the latest bounded catch-up. */
707
+ last_catchup_at_ms?: number | null;
708
+ /** Occurrences coalesced by the latest recovery fire. */
709
+ last_coalesced_count: number;
710
+ /** Actionable recurrence error when `end_reason` is `planning_failed`. */
711
+ last_planning_error?: string | null;
712
+ overlap_policy: ScheduleOverlapPolicy;
713
+ /** Optional retry override for `queue_after_previous`. */
714
+ overlap_retry_ms: number | null;
715
+ next_run_at_ms?: number | null;
716
+ /** Targets actually created; coalesced occurrences are excluded. */
717
+ fire_count: number;
718
+ attempts: number;
719
+ skipped_count: number;
720
+ };
721
+ /** Aggregate outcome from one bounded due-schedule claim batch. */
722
+ type ScheduleFireDueResult = FlowAdminRecord & {
723
+ claimed: number;
724
+ fired: number;
725
+ skipped: number;
726
+ coalesced: number;
727
+ errors: [string, string][];
728
+ /** Batch-level failure encountered while requesting a later claim wave. */
729
+ claim_error?: string | null;
730
+ last_target_id?: string;
731
+ last_skip_reason?: string;
732
+ };
733
+ /** Outcome from one explicit schedule fire and its canonical schedule state. */
734
+ type ScheduleFireResult = FlowAdminRecord & {
735
+ fired: 0 | 1;
736
+ skipped: 0 | 1;
737
+ target_id?: string;
738
+ reason?: string;
739
+ schedule: ScheduleRecord;
740
+ };
684
741
  interface FlowStatsOptions {
685
742
  state?: string;
686
743
  partitionKey?: string;
@@ -696,14 +753,16 @@ interface AttributeQueryOptions {
696
753
  }
697
754
  interface ScheduleOptions {
698
755
  target: Record<string, unknown>;
699
- kind?: string;
756
+ kind?: ScheduleKind;
700
757
  atMs?: number;
701
758
  delayMs?: number;
702
759
  startAtMs?: number;
703
760
  everyMs?: number;
704
761
  cron?: string;
705
762
  timezone?: string;
706
- overlapPolicy?: string;
763
+ /** Interval-only recovery policy. Defaults to `fire_once`. */
764
+ catchupPolicy?: ScheduleCatchupPolicy;
765
+ overlapPolicy?: ScheduleOverlapPolicy;
707
766
  overlapRetryMs?: number;
708
767
  maxFires?: number;
709
768
  endAtMs?: number;
@@ -712,8 +771,8 @@ interface ScheduleOptions {
712
771
  extraOptions?: Record<string, CommandArgument>;
713
772
  }
714
773
  interface ScheduleListOptions {
715
- kind?: string;
716
- state?: string;
774
+ kind?: ScheduleKind;
775
+ state?: ScheduleState | "all";
717
776
  timezone?: string;
718
777
  targetType?: string;
719
778
  fromMs?: number;
@@ -724,9 +783,14 @@ interface ScheduleListOptions {
724
783
  interface ScheduleFireDueOptions {
725
784
  nowMs?: number;
726
785
  worker?: string;
786
+ leaseMs?: number;
727
787
  blockMs?: number;
728
788
  limit?: number;
729
789
  }
790
+ interface ScheduleFireOptions {
791
+ fireAtMs?: number;
792
+ nowMs?: number;
793
+ }
730
794
  interface EffectReserveOptions {
731
795
  partitionKey?: string;
732
796
  leaseToken?: Buffer;
@@ -1122,10 +1186,10 @@ interface FlowQueryPage {
1122
1186
  readonly cursor?: string;
1123
1187
  }
1124
1188
  interface FlowQueryQuality {
1125
- readonly exactness: string;
1126
- readonly freshness: string;
1127
- readonly coverage: string;
1128
- readonly pagination: string;
1189
+ readonly exactness: "authoritative" | "projected_exact" | "exact" | "not_applicable";
1190
+ readonly freshness: "current" | "projection_watermark" | "not_applicable";
1191
+ readonly coverage: "complete" | "unavailable";
1192
+ readonly pagination: "none" | "complete" | "authenticated_seek" | "live_seek";
1129
1193
  }
1130
1194
  interface FlowQueryUsage {
1131
1195
  readonly rangeSeeks: number;
@@ -1181,13 +1245,25 @@ declare class FlowQueryError extends FerricStoreError {
1181
1245
  readonly cause?: unknown;
1182
1246
  });
1183
1247
  }
1248
+ interface FlowExplainCapabilities {
1249
+ readonly requested: readonly string[];
1250
+ readonly available: readonly string[];
1251
+ readonly missing: readonly string[];
1252
+ readonly raw: Readonly<Record<string, unknown>>;
1253
+ }
1184
1254
  interface FlowExplainResult {
1185
1255
  readonly version: "ferric.flow.explain/v1";
1186
1256
  readonly queryFingerprint: string;
1187
1257
  readonly status: "planned" | "rejected" | "executed";
1188
1258
  readonly plan: Readonly<Record<string, unknown>>;
1189
1259
  readonly estimate: Readonly<Record<string, unknown>>;
1260
+ readonly stats?: Readonly<Record<string, unknown>>;
1261
+ readonly quality?: FlowQueryQuality;
1190
1262
  readonly bounds: Readonly<Record<string, unknown>>;
1263
+ readonly pressure?: Readonly<Record<string, unknown>>;
1264
+ readonly decision?: Readonly<Record<string, unknown>>;
1265
+ readonly alternatives: readonly Readonly<Record<string, unknown>>[];
1266
+ readonly capabilities?: FlowExplainCapabilities;
1191
1267
  readonly actual?: FlowQueryUsage;
1192
1268
  readonly diagnostic?: FlowQueryError;
1193
1269
  readonly raw: Readonly<Record<string, unknown>>;
@@ -1196,6 +1272,20 @@ interface FlowQueryIndexRegistry {
1196
1272
  readonly epoch: FlowQueryInteger;
1197
1273
  readonly catalogVersion: FlowQueryInteger;
1198
1274
  }
1275
+ type FlowQueryIndexServiceState = "ready" | "unavailable";
1276
+ interface FlowQueryIndexServices {
1277
+ readonly registry: FlowQueryIndexServiceState;
1278
+ readonly lifecycleWorker: FlowQueryIndexServiceState;
1279
+ readonly statisticsStore: FlowQueryIndexServiceState;
1280
+ readonly statisticsWorker: FlowQueryIndexServiceState;
1281
+ readonly raw: Readonly<Record<string, unknown>>;
1282
+ }
1283
+ interface FlowQueryIndexField {
1284
+ readonly name: string;
1285
+ readonly direction: "asc" | "desc";
1286
+ readonly encoding: "hashed" | "ordered";
1287
+ readonly raw: Readonly<Record<string, unknown>>;
1288
+ }
1199
1289
  interface FlowQueryIndexFormat {
1200
1290
  readonly queryRow: string;
1201
1291
  readonly key: string;
@@ -1204,22 +1294,81 @@ interface FlowQueryIndexFormat {
1204
1294
  readonly counter?: string;
1205
1295
  readonly raw: Readonly<Record<string, unknown>>;
1206
1296
  }
1297
+ interface FlowQueryIndexCoverage {
1298
+ readonly completeShards: FlowQueryInteger;
1299
+ readonly totalShards: FlowQueryInteger;
1300
+ readonly validation: "pending" | "passed" | "failed";
1301
+ readonly raw: Readonly<Record<string, unknown>>;
1302
+ }
1303
+ interface FlowQueryIndexProgress {
1304
+ readonly scope: "catalog_build";
1305
+ readonly phaseCounts: Readonly<Record<string, FlowQueryInteger>>;
1306
+ readonly currentPhases: readonly string[];
1307
+ readonly completedShards: FlowQueryInteger;
1308
+ readonly totalShards: FlowQueryInteger;
1309
+ readonly raw: Readonly<Record<string, unknown>>;
1310
+ }
1311
+ interface FlowQueryIndexBuild extends FlowQueryIndexProgress {
1312
+ readonly scannedRecords: FlowQueryInteger;
1313
+ readonly writtenEntries: FlowQueryInteger;
1314
+ readonly writtenBytes: FlowQueryInteger;
1315
+ }
1316
+ interface FlowQueryIndexValidation extends FlowQueryIndexProgress {
1317
+ readonly status: "pending" | "passed" | "failed";
1318
+ readonly checkedRecords: FlowQueryInteger;
1319
+ readonly checkedEntries: FlowQueryInteger;
1320
+ readonly mismatches: FlowQueryInteger;
1321
+ readonly failureReason?: string;
1322
+ readonly validatedAtMs?: FlowQueryInteger;
1323
+ }
1324
+ interface FlowQueryIndexRetirement {
1325
+ readonly status: "not_applicable" | "pending" | "complete";
1326
+ readonly phaseCounts?: Readonly<Record<string, FlowQueryInteger>>;
1327
+ readonly currentPhases?: readonly string[];
1328
+ readonly completedShards?: FlowQueryInteger;
1329
+ readonly totalShards?: FlowQueryInteger;
1330
+ readonly deletedEntries?: FlowQueryInteger;
1331
+ readonly deletedBytes?: FlowQueryInteger;
1332
+ readonly rewrittenReverseRows?: FlowQueryInteger;
1333
+ readonly raw: Readonly<Record<string, unknown>>;
1334
+ }
1335
+ interface FlowQueryIndexStatistics {
1336
+ readonly status: "fresh" | "stale" | "future" | "mixed" | "missing" | "unavailable";
1337
+ readonly samples: FlowQueryInteger;
1338
+ readonly freshSamples: FlowQueryInteger;
1339
+ readonly staleSamples: FlowQueryInteger;
1340
+ readonly futureSamples: FlowQueryInteger;
1341
+ readonly oldestCollectedAtMs?: FlowQueryInteger;
1342
+ readonly newestCollectedAtMs?: FlowQueryInteger;
1343
+ readonly oldestAgeMs?: FlowQueryInteger;
1344
+ readonly newestAgeMs?: FlowQueryInteger;
1345
+ readonly raw: Readonly<Record<string, unknown>>;
1346
+ }
1207
1347
  interface FlowQueryIndex {
1208
1348
  readonly id: string;
1209
1349
  readonly version: FlowQueryInteger;
1210
1350
  readonly buildId: string;
1211
- readonly state: string;
1351
+ readonly source: "runs";
1352
+ readonly state: "building" | "validating" | "active" | "retiring" | "failed";
1212
1353
  readonly queryable: boolean;
1354
+ readonly fields: readonly FlowQueryIndexField[];
1355
+ readonly workloads: readonly string[];
1356
+ readonly countPrefixes: readonly number[];
1213
1357
  readonly coveringFields: readonly string[];
1214
1358
  readonly format: FlowQueryIndexFormat;
1359
+ readonly coverage: FlowQueryIndexCoverage;
1360
+ readonly build: FlowQueryIndexBuild;
1361
+ readonly validation: FlowQueryIndexValidation;
1362
+ readonly retirement: FlowQueryIndexRetirement;
1363
+ readonly statistics: FlowQueryIndexStatistics;
1215
1364
  readonly raw: Readonly<Record<string, unknown>>;
1216
1365
  }
1217
1366
  interface FlowQueryIndexStatus {
1218
1367
  readonly contractVersion: "ferric.flow.query.indexes/v1";
1219
- readonly observedAtMs: number;
1220
- readonly statisticsMaxAgeMs: number;
1368
+ readonly observedAtMs: FlowQueryInteger;
1369
+ readonly statisticsMaxAgeMs: FlowQueryInteger;
1221
1370
  readonly registry: FlowQueryIndexRegistry;
1222
- readonly services: Readonly<Record<string, unknown>>;
1371
+ readonly services: FlowQueryIndexServices;
1223
1372
  readonly indexes: readonly FlowQueryIndex[];
1224
1373
  readonly raw: Readonly<Record<string, unknown>>;
1225
1374
  }
@@ -1869,31 +2018,31 @@ declare class FerricStoreClientCore extends FerricStoreAdministrationClient {
1869
2018
  }): Promise<boolean>;
1870
2019
  }
1871
2020
 
1872
- /** @internal Administrative and governance commands kept off the primary Flow client surface. */
1873
- declare class FerricStoreManagementClient extends FerricStoreClientCore {
1874
- stats(type: string, options?: FlowStatsOptions): Promise<FlowAdminRecord>;
1875
- countByState(type: string, state: string, options?: Omit<FlowStatsOptions, "state" | "count">): Promise<number>;
1876
- attributes(type: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
1877
- attributeValues(type: string, attribute: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
1878
- scheduleCreate(id: string, options: ScheduleOptions): Promise<FlowAdminRecord>;
1879
- scheduleGet(id: string, options?: {
1880
- nowMs?: number;
1881
- }): Promise<FlowAdminRecord | null>;
1882
- scheduleFire(id: string, options?: {
1883
- nowMs?: number;
1884
- }): Promise<FlowAdminRecord>;
2021
+ /** @internal Schedule management surface shared by the complete Flow client. */
2022
+ declare class FerricStoreScheduleClient extends FerricStoreClientCore {
2023
+ scheduleCreate(id: string, options: ScheduleOptions): Promise<ScheduleRecord>;
2024
+ scheduleGet(id: string): Promise<ScheduleRecord | null>;
2025
+ scheduleFire(id: string, options?: ScheduleFireOptions): Promise<ScheduleFireResult>;
1885
2026
  schedulePause(id: string, options?: {
1886
2027
  nowMs?: number;
1887
- }): Promise<FlowAdminRecord>;
2028
+ }): Promise<ScheduleRecord>;
1888
2029
  scheduleResume(id: string, options?: {
1889
2030
  nowMs?: number;
1890
- }): Promise<FlowAdminRecord>;
2031
+ }): Promise<ScheduleRecord>;
1891
2032
  scheduleDelete(id: string, options?: {
1892
2033
  nowMs?: number;
1893
- }): Promise<FlowAdminRecord>;
1894
- scheduleFireDue(options?: ScheduleFireDueOptions): Promise<FlowAdminRecord>;
1895
- scheduleList(options?: ScheduleListOptions): Promise<FlowAdminRecord[]>;
1896
- private scheduleStatus;
2034
+ }): Promise<void>;
2035
+ scheduleFireDue(options?: ScheduleFireDueOptions): Promise<ScheduleFireDueResult>;
2036
+ scheduleList(options?: ScheduleListOptions): Promise<ScheduleRecord[]>;
2037
+ private scheduleStatusResponse;
2038
+ }
2039
+
2040
+ /** @internal Administrative and governance commands kept off the primary Flow client surface. */
2041
+ declare class FerricStoreManagementClient extends FerricStoreScheduleClient {
2042
+ stats(type: string, options?: FlowStatsOptions): Promise<FlowAdminRecord>;
2043
+ countByState(type: string, state: string, options?: Omit<FlowStatsOptions, "state" | "count">): Promise<number>;
2044
+ attributes(type: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
2045
+ attributeValues(type: string, attribute: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
1897
2046
  effectReserve(id: string, effectKey: string, effectType: string, options: EffectReserveOptions): Promise<FlowAdminRecord>;
1898
2047
  effectConfirm(id: string, effectKey: string, options?: EffectConfirmOptions): Promise<FlowAdminRecord>;
1899
2048
  effectFail(id: string, effectKey: string, options?: EffectFailOptions): Promise<FlowAdminRecord>;
@@ -2567,13 +2716,13 @@ declare class WorkflowWorker {
2567
2716
  }
2568
2717
 
2569
2718
  /** TypeScript SDK package version. */
2570
- declare const FERRICSTORE_SDK_VERSION = "0.5.1";
2719
+ declare const FERRICSTORE_SDK_VERSION = "0.11.4";
2571
2720
  /** Oldest FerricStore server supported by this breaking beta contract. */
2572
- declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.0";
2721
+ declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
2573
2722
  /** Native framing and opcode ABI version; unchanged by FerricStore 0.11. */
2574
2723
  declare const FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
2575
2724
 
2576
2725
  /** @deprecated Use RequestDisposition; retained for source compatibility. */
2577
2726
  type ConnectionRequestDisposition = RequestDisposition;
2578
2727
 
2579
- export { type AdminListOptions, type ApprovalListOptions, type ApprovalRequestOptions, type AttributeQueryOptions, type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, type BudgetCommitOptions, type BudgetReserveOptions, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type CircuitOpenOptions, type ClaimDueOptions, ClaimHydrationError, type ClaimHydrationItem, type ClaimedItem, type Codec, type CollectionScanOptions, type Command, type CommandArgument, type CommandExecutor, type CompleteJobsAndClaimJobsResult, type CompleteManyOptions, type CompleteOptions, type CompleteOutcome, ConnectionClosedError, type ConnectionRequestDisposition, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EffectCompensateOptions, type EffectConfirmOptions, type EffectFailOptions, type EffectReserveOptions, type EffectStatusOptions, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type ExpiryCondition, type ExtendLeaseOptions, FERRICSTORE_MINIMUM_SERVER_VERSION, FERRICSTORE_NATIVE_PROTOCOL_VERSION, FERRICSTORE_SDK_VERSION, type FailOptions, type FailOutcome, type FencedItem, type FencingToken, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeComputeResult, type FetchOrComputeFencedResult, type FetchOrComputeHitResult, type FetchOrComputeResult, type FlowAdminRecord, FlowAlreadyExistsError, type FlowBatchCompletedItem, FlowBatchError, type FlowEventProjectionField, type FlowExplainResult, type FlowMaxActiveFailure, FlowNotFoundError, type FlowPolicyBackoffKind, type FlowPolicyBackoffSnapshot, type FlowPolicyOptions, type FlowPolicyRetentionSnapshot, type FlowPolicyRetrySnapshot, type FlowPolicySnapshot, type FlowPolicyStateSnapshot, FlowProjection, type FlowProjectionField, type FlowProjectionShape, type FlowQueryCountResult, FlowQueryError, type FlowQueryErrorPosition, type FlowQueryIndex, type FlowQueryIndexFormat, type FlowQueryIndexRegistry, type FlowQueryIndexStatus, type FlowQueryInteger, type FlowQueryPage, type FlowQueryParameter, type FlowQueryParameters, type FlowQueryQuality, type FlowQueryRecord, type FlowQueryRecordsResult, type FlowQueryResult, type FlowQueryUsage, type FlowRecord, type FlowRunProjectionField, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, type FlowStatsOptions, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, type GovernanceLedgerOptions, type HashScanResult, HashStore, type HistoryOptions, HyperLogLogStore, type IntegerReply, InvalidCommandError, type InvocationCreateOptions, JsonCodec, type KeyInfo, KeyValueStore, type LeaseMutationOptions, LeaseRenewalError, type LimitAmountOptions, type LimitLeaseOptions, type LimitListOptions, type LimitReleaseOptions, ListStore, LockHeldError, LockNotOwnedError, MAX_FLOW_POLICY_GENERATION, type ManagementPairs, type MaxActiveMs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type NativeClientOptions, type NativeProtocolEvent, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, QueueCompletionError, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, type RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RequestContext, type RequestContextOptions, type RequestDisposition, RequestTimeoutError, RerouteError, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type RunStepsItem, type RunStepsManyOptions, type ScanOptions, type ScheduleFireDueOptions, type ScheduleListOptions, type ScheduleOptions, type SearchOptions, type SearchStateMeta, type SetOptions, type SetScanResult, SetStore, type SortedSetScanResult, SortedSetStore, StaleLeaseError, StalePolicyGenerationError, type StartAndClaimOptions, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StepContinueOptions, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, type TopologyNativeAdapterOptions, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, type WorkerRefillStrategy, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, isOutcome, isReconnectableClosedConnectionError, mapException, projectFlowQuery, retry, transition };
2728
+ export { type AdminListOptions, type ApprovalListOptions, type ApprovalRequestOptions, type AttributeQueryOptions, type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, type BudgetCommitOptions, type BudgetReserveOptions, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type CircuitOpenOptions, type ClaimDueOptions, ClaimHydrationError, type ClaimHydrationItem, type ClaimedItem, type Codec, type CollectionScanOptions, type Command, type CommandArgument, type CommandExecutor, type CompleteJobsAndClaimJobsResult, type CompleteManyOptions, type CompleteOptions, type CompleteOutcome, ConnectionClosedError, type ConnectionRequestDisposition, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EffectCompensateOptions, type EffectConfirmOptions, type EffectFailOptions, type EffectReserveOptions, type EffectStatusOptions, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type ExpiryCondition, type ExtendLeaseOptions, FERRICSTORE_MINIMUM_SERVER_VERSION, FERRICSTORE_NATIVE_PROTOCOL_VERSION, FERRICSTORE_SDK_VERSION, type FailOptions, type FailOutcome, type FencedItem, type FencingToken, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeComputeResult, type FetchOrComputeFencedResult, type FetchOrComputeHitResult, type FetchOrComputeResult, type FlowAdminRecord, FlowAlreadyExistsError, type FlowBatchCompletedItem, FlowBatchError, type FlowEventProjectionField, type FlowExplainCapabilities, type FlowExplainResult, type FlowMaxActiveFailure, FlowNotFoundError, type FlowPolicyBackoffKind, type FlowPolicyBackoffSnapshot, type FlowPolicyOptions, type FlowPolicyRetentionSnapshot, type FlowPolicyRetrySnapshot, type FlowPolicySnapshot, type FlowPolicyStateSnapshot, FlowProjection, type FlowProjectionField, type FlowProjectionShape, type FlowQueryCountResult, FlowQueryError, type FlowQueryErrorPosition, type FlowQueryIndex, type FlowQueryIndexBuild, type FlowQueryIndexCoverage, type FlowQueryIndexField, type FlowQueryIndexFormat, type FlowQueryIndexProgress, type FlowQueryIndexRegistry, type FlowQueryIndexRetirement, type FlowQueryIndexServiceState, type FlowQueryIndexServices, type FlowQueryIndexStatistics, type FlowQueryIndexStatus, type FlowQueryIndexValidation, type FlowQueryInteger, type FlowQueryPage, type FlowQueryParameter, type FlowQueryParameters, type FlowQueryQuality, type FlowQueryRecord, type FlowQueryRecordsResult, type FlowQueryResult, type FlowQueryUsage, type FlowRecord, type FlowRunProjectionField, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, type FlowStatsOptions, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, type GovernanceLedgerOptions, type HashScanResult, HashStore, type HistoryOptions, HyperLogLogStore, type IntegerReply, InvalidCommandError, type InvocationCreateOptions, JsonCodec, type KeyInfo, KeyValueStore, type LeaseMutationOptions, LeaseRenewalError, type LimitAmountOptions, type LimitLeaseOptions, type LimitListOptions, type LimitReleaseOptions, ListStore, LockHeldError, LockNotOwnedError, MAX_FLOW_POLICY_GENERATION, type ManagementPairs, type MaxActiveMs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type NativeClientOptions, type NativeProtocolEvent, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, QueueCompletionError, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, type RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RequestContext, type RequestContextOptions, type RequestDisposition, RequestTimeoutError, RerouteError, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type RunStepsItem, type RunStepsManyOptions, type ScanOptions, type ScheduleCatchupPolicy, type ScheduleFireDueOptions, type ScheduleFireDueResult, type ScheduleFireOptions, type ScheduleFireResult, type ScheduleKind, type ScheduleListOptions, type ScheduleOptions, type ScheduleOverlapPolicy, type ScheduleRecord, type ScheduleState, type SearchOptions, type SearchStateMeta, type SetOptions, type SetScanResult, SetStore, type SortedSetScanResult, SortedSetStore, StaleLeaseError, StalePolicyGenerationError, type StartAndClaimOptions, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StepContinueOptions, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, type TopologyNativeAdapterOptions, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, type WorkerRefillStrategy, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, isOutcome, isReconnectableClosedConnectionError, mapException, projectFlowQuery, retry, transition };