@camstack/types 1.2.380 → 1.2.382

package/dist/interfaces/addon-peer-bytes.d.ts

@@ -62,7 +62,7 @@
  * handle. A caller that minted an offer per frame would exhaust the outstanding
  * bound inside a second and be refused by name.
  */
-import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { IncomingMessage } from 'node:http';
 import type { Readable } from 'node:stream';
 import { z } from 'zod';
 /**
@@ -145,7 +145,23 @@ export interface PeerBytesOfferOptions {
     readonly declaredBytes?: number;
     readonly ttlMs?: number;
 }
-export type PeerBytesHandler = (req: IncomingMessage, res: ServerResponse) => void | Promise<void>;
+type PeerBytesResponseEvent = 'close' | 'drain' | 'data';
+/** Minimal `ServerResponse` surface peer-bytes producers write through. */
+export interface PeerBytesHandlerResponse {
+    readonly headersSent: boolean;
+    readonly writable: boolean;
+    readonly destroyed: boolean;
+    readonly writableEnded: boolean;
+    writeHead(statusCode: number, statusMessage?: string, headers?: Record<string, string>): this;
+    writeHead(statusCode: number, headers?: Record<string, string>): this;
+    write(chunk: Uint8Array | string): boolean;
+    end(cb?: () => void): this;
+    destroy(err?: Error): this;
+    on(event: PeerBytesResponseEvent, listener: (...args: readonly unknown[]) => void): this;
+    once(event: 'close' | 'drain', listener: () => void): this;
+    off(event: 'close' | 'drain', listener: () => void): this;
+}
+export type PeerBytesHandler = (req: IncomingMessage, res: PeerBytesHandlerResponse) => void | Promise<void>;
 /** A buffer the producer already holds, written out in bounded chunks. */
 export interface PeerBytesBufferOffer {
     readonly bytes: Buffer;
@@ -242,3 +258,4 @@ export interface AddonPeerBytes {
     offerFile(options: PeerBytesFileOffer): Promise<PeerBytesOfferResult>;
     open(ticket: PeerBytesTicket): Promise<PeerBytesOpenResult>;
 }
+export {};

package/dist/interfaces/config-ui-secrets.d.ts

@@ -51,6 +51,8 @@ export declare function collectSecretConfigKeys(schema: unknown): ReadonlySet<st
  * blobs (see {@link isKeychainStoredField}). What a form sends as
  * `secretKeys` so the owner's door knows which values to keep out of the blob.
  */
+/** Drop fields marked `omitFromSettings` before an integration settings write. */
+export declare function omitTransientConfig(schema: unknown, config: Record<string, unknown>): Record<string, unknown>;
 export declare function collectKeychainStoredKeys(schema: unknown): ReadonlySet<string>;
 /**
  * True when the value is a readable schema declaring at least one field of any

package/dist/interfaces/config-ui.d.ts

@@ -143,6 +143,11 @@ export interface ConfigFieldBase {
     readonly default?: unknown;
     readonly span?: 1 | 2 | 3 | 4;
     readonly showWhen?: ConfigCondition;
+    /**
+     * The value is only for an in-form action (a sign-in). It is not written
+     * into the integration settings.
+     */
+    readonly omitFromSettings?: boolean;
     /**
      * The field's stored value is a CREDENTIAL and must never leave the process
      * on a read surface. Redaction machinery keys off
@@ -942,6 +947,11 @@ export interface ConfigAddonActionButtonField extends ConfigFieldBase {
     /** Toast/inline success message template. `{key}` placeholders are
      *  resolved against the action result. */
     successMessage?: string;
+    /**
+     * After a successful action, copy string fields from the result into form
+     * keys (e.g. pairing writes `sslCertificate` without showing PEM fields).
+     */
+    assignResult?: Readonly<Record<string, string>>;
     /** Confirmation prompt before executing. */
     confirmMessage?: string;
 }
@@ -1144,3 +1154,7 @@ export interface HydrateSchemaOptions {
     readonly inlineSecretsAsViews?: boolean;
 }
 export declare function hydrateSchema(schema: ConfigUISchema, values: Record<string, unknown>, options?: HydrateSchemaOptions): ConfigUISchemaWithValues;
+/** Strip inline `value` from a hydrated field for schema-only round-trips. */
+export declare function dehydrateConfigField(field: ConfigFieldWithValue): ConfigField;
+/** Inverse of {@link hydrateSchema} — drops resolved values from every leaf field. */
+export declare function dehydrateSchema(schema: ConfigUISchemaWithValues): ConfigUISchema;

package/dist/node.d.ts

@@ -10,8 +10,8 @@ export type { Fmp4FragmentChildArgs, Fmp4FragmentChildDeps, } from './ffmpeg/fmp
 export { Fmp4FragmentChild } from './ffmpeg/fmp4-fragment-child.js';
 export type { Fmp4CloseReason, Fmp4Packet, Fmp4PrebufferOptions, Fmp4PrebufferStats, Fmp4SubscribeInput, Fmp4SubscriberInfo, Fmp4Subscription, } from './ffmpeg/fmp4-fragment-plane.js';
 export { Fmp4FragmentPlane } from './ffmpeg/fmp4-fragment-plane.js';
-export type { FfmpegExit, FfmpegExitClass, FfmpegProcessOptions } from './ffmpeg/process.js';
-export { FfmpegProcess } from './ffmpeg/process.js';
+export type { FfmpegExit, FfmpegExitClass, FfmpegProcessOptions, FfmpegSpawnFn, SpawnedFfmpegProcess, } from './ffmpeg/process.js';
+export { defaultFfmpegSpawn, FfmpegProcess } from './ffmpeg/process.js';
 export type { FfmpegArgvSpawn, PinnedFfmpegSpawnAnswer } from './ffmpeg/pinned-spawn.js';
 export { NO_PINNED_FFMPEG_DETAIL, pinnedFfmpegSpawner, resolvePinnedFfmpegSpawner, } from './ffmpeg/pinned-spawn.js';
 export type { ChildCostClaimHandle, ChildCostClaimInput, ProcStatReader, } from './process/child-cost-registry.js';

package/dist/node.js

@@ -21,8 +21,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_composition = require("./composition-CUAOHZ38.js");
-const require_err_msg = require("./err-msg-Bb-s4Xuj.js");
+const require_composition = require("./composition-eoYYVfOp.js");
+const require_err_msg = require("./err-msg-BhVbr0NX.js");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 node_fs = __toESM(node_fs);
@@ -1410,6 +1410,9 @@ var Fmp4FragmentPlane = class {
 * that also owned the bytes would need a mode per consumer, which is the same
 * mistake as one builder per consumer.
 */
+function defaultFfmpegSpawn(command, args, options) {
+	return (0, node_child_process.spawn)(command, args, options ?? {});
+}
 var DEFAULT_FIRST_DATA_TIMEOUT_MS = 8e3;
 var DEFAULT_RESTART_DELAY_MS = 1e3;
 var DEFAULT_STABLE_RUN_MS = 3e4;
@@ -2285,6 +2288,7 @@ exports.canonicalDeviceFingerprint = canonicalDeviceFingerprint;
 exports.canonicalHash = require_composition.canonicalHash;
 exports.containsOrEquals = containsOrEquals;
 exports.customizationBlockName = customizationBlockName;
+exports.defaultFfmpegSpawn = defaultFfmpegSpawn;
 exports.diffExportTargets = diffExportTargets;
 exports.downloadBinary = downloadBinary;
 exports.ensureBinary = ensureBinary;

package/dist/node.mjs

@@ -1,5 +1,5 @@
-import { At as Fmp4BoxSplitter, Ct as FFMPEG_PATH_ENV, Dt as getFfmpegArtifact, Et as FFMPEG_RELEASE, Ot as getFfmpegDownloadUrl, P as compositionSourceKey, Pt as buildFfmpegArgs, Rt as isSoftwareDecode, Tt as ffmpegBinaryName, a as CUSTOMIZATION_BLOCK_NAME_PREFIX, kt as canonicalHash, wt as chooseFfmpegBinary } from "./composition-DOwQB_Ua.mjs";
-import { t as errMsg } from "./err-msg--2RrYiLO.mjs";
+import { At as Fmp4BoxSplitter, Ct as FFMPEG_PATH_ENV, Dt as getFfmpegArtifact, Et as FFMPEG_RELEASE, Ot as getFfmpegDownloadUrl, P as compositionSourceKey, Pt as buildFfmpegArgs, Rt as isSoftwareDecode, Tt as ffmpegBinaryName, a as CUSTOMIZATION_BLOCK_NAME_PREFIX, kt as canonicalHash, wt as chooseFfmpegBinary } from "./composition-CB6PMT9p.mjs";
+import { t as errMsg } from "./err-msg-BXKzRBwg.mjs";
 import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
 import * as fs from "node:fs";
 import { chmodSync, createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
@@ -1387,6 +1387,9 @@ var Fmp4FragmentPlane = class {
 * that also owned the bytes would need a mode per consumer, which is the same
 * mistake as one builder per consumer.
 */
+function defaultFfmpegSpawn(command, args, options) {
+	return spawn(command, args, options ?? {});
+}
 var DEFAULT_FIRST_DATA_TIMEOUT_MS = 8e3;
 var DEFAULT_RESTART_DELAY_MS = 1e3;
 var DEFAULT_STABLE_RUN_MS = 3e4;
@@ -2247,4 +2250,4 @@ function resolveExportFingerprint(input) {
 	return input.persisted ?? input.fresh;
 }
 //#endregion
-export { ChildCostRegistry, FFMPEG_RELEASE, FfmpegProcess, FilesystemStorageProvider, Fmp4FragmentChild, Fmp4FragmentPlane, NO_COST_CLAIM, NO_PINNED_FFMPEG_DETAIL, OwnerOnlyError, PYTHON_VERSION, buildBinaryPath, canonicalDeviceFingerprint, canonicalHash, containsOrEquals, customizationBlockName, diffExportTargets, downloadBinary, ensureBinary, ensureFfmpeg, ensurePython, findInPath, getFfmpegArtifact, getFfmpegDownloadUrl, getPlatformInfo, getPythonDownloadUrl, icaclsArgs, installPythonPackages, installPythonRequirements, mkdirOwnerOnlySync, nodeProcStatReader, parseFfmpegCapabilities, parseProcCpuSeconds, parseProcRssBytes, physicalRootOf, pinnedFfmpegSpawner, probeFfmpegBinary, readProcessCost, resolveExportFingerprint, resolvePinnedFfmpegSpawner, restrictDirToOwnerSync, restrictFileToOwnerSync, signExpiringUrl, verifyExpiringUrl, writeFileAtomic, writeOwnerOnlyFileSync };
+export { ChildCostRegistry, FFMPEG_RELEASE, FfmpegProcess, FilesystemStorageProvider, Fmp4FragmentChild, Fmp4FragmentPlane, NO_COST_CLAIM, NO_PINNED_FFMPEG_DETAIL, OwnerOnlyError, PYTHON_VERSION, buildBinaryPath, canonicalDeviceFingerprint, canonicalHash, containsOrEquals, customizationBlockName, defaultFfmpegSpawn, diffExportTargets, downloadBinary, ensureBinary, ensureFfmpeg, ensurePython, findInPath, getFfmpegArtifact, getFfmpegDownloadUrl, getPlatformInfo, getPythonDownloadUrl, icaclsArgs, installPythonPackages, installPythonRequirements, mkdirOwnerOnlySync, nodeProcStatReader, parseFfmpegCapabilities, parseProcCpuSeconds, parseProcRssBytes, physicalRootOf, pinnedFfmpegSpawner, probeFfmpegBinary, readProcessCost, resolveExportFingerprint, resolvePinnedFfmpegSpawner, restrictDirToOwnerSync, restrictFileToOwnerSync, signExpiringUrl, verifyExpiringUrl, writeFileAtomic, writeOwnerOnlyFileSync };

package/dist/records/in-memory-records.d.ts

@@ -0,0 +1,21 @@
+import { type RecordsAccess } from './records-access.js';
+interface StoredRow {
+    readonly id: string;
+    readonly at: number | null;
+    readonly rev: number;
+    readonly updatedAt: number;
+    readonly data: Record<string, unknown>;
+}
+export interface InMemoryRecords {
+    readonly records: RecordsAccess;
+    readonly tables: ReadonlyMap<string, ReadonlyMap<string, StoredRow>>;
+    seed(kind: string, row: {
+        id: string;
+        at?: number;
+        data: Record<string, unknown>;
+    }): void;
+    failWrites(on: boolean): void;
+    failReads(on: boolean): void;
+}
+export declare function makeInMemoryRecords(owner?: string): InMemoryRecords;
+export {};

package/dist/records/index.d.ts

@@ -4,3 +4,6 @@ export * from './record-kind.js';
 export * from './secret-paths.js';
 export * from './records-access.js';
 export * from './entry-kind.js';
+export * from './settings-brokers-adopts-from.js';
+export * from './settings-array-adopts-from.js';
+export { makeInMemoryRecords, type InMemoryRecords } from './in-memory-records.js';

package/dist/records/settings-array-adopts-from.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Legacy source for entry adoption (B3): a list stored under addon-settings
+ * `<addonId>.<key>` until records-adopt copies rows into the entry kind.
+ */
+export declare const SETTINGS_ARRAY_ADOPTS_PREFIX = "@settings-array/";
+/** The `adoptsFrom` value for an addon-settings array field. */
+export declare function settingsArrayAdoptsFrom(addonId: string, settingsKey: string): string;
+/** When non-null, `from` names an addon-settings array blob, not a SQL table. */
+export declare function parseSettingsArrayAdoptsFrom(from: string): {
+    readonly addonId: string;
+    readonly settingsKey: string;
+} | null;

package/dist/records/settings-brokers-adopts-from.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Legacy source for broker entry adoption (B2): brokers live in addon-settings
+ * as one row `<addonId>.brokers` whose value is an array until records-adopt
+ * copies them into the entry kind.
+ */
+export declare const SETTINGS_BROKERS_ADOPTS_PREFIX = "@settings-brokers/";
+/** The `adoptsFrom` value for an addon's broker entry kind. */
+export declare function settingsBrokersAdoptsFrom(addonId: string): string;
+/** When non-null, `from` names an addon-settings brokers blob, not a SQL table. */
+export declare function parseSettingsBrokersAdoptsFrom(from: string): string | null;