@malloy-publisher/sdk 0.0.224 → 0.0.225
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.
- package/dist/client/api.d.ts +43 -0
- package/package.json +1 -1
package/dist/client/api.d.ts
CHANGED
|
@@ -236,6 +236,18 @@ export interface BuildInstructions {
|
|
|
236
236
|
* @memberof BuildInstructions
|
|
237
237
|
*/
|
|
238
238
|
'sources': Array<BuildInstruction>;
|
|
239
|
+
/**
|
|
240
|
+
* Already-materialized persist upstreams the built sources may reference but which are NOT rebuilt in this run. The publisher seeds the build Manifest with these so a downstream source\'s upstream persist reference resolves to the existing physical table instead of recomputing it live. Only consumed on the orchestrated (buildInstructions) path; auto-run seeds its own reference set from the most-recent manifest.
|
|
241
|
+
* @type {Array<ManifestReference>}
|
|
242
|
+
* @memberof BuildInstructions
|
|
243
|
+
*/
|
|
244
|
+
'referenceManifest'?: Array<ManifestReference>;
|
|
245
|
+
/**
|
|
246
|
+
* When true, a persist upstream that is neither built here nor present in referenceManifest fails the build (compiler strict mode) instead of silently recomputing it live. Per-unit dispatch should set this true.
|
|
247
|
+
* @type {boolean}
|
|
248
|
+
* @memberof BuildInstructions
|
|
249
|
+
*/
|
|
250
|
+
'strictUpstreams'?: boolean;
|
|
239
251
|
}
|
|
240
252
|
/**
|
|
241
253
|
* Build output. Maps each sourceEntityId a build produced to its physical table. Returned inline; the caller persists it.
|
|
@@ -1227,6 +1239,25 @@ export declare const ManifestEntryFreshnessFallbackEnum: {
|
|
|
1227
1239
|
readonly Fail: "fail";
|
|
1228
1240
|
};
|
|
1229
1241
|
export type ManifestEntryFreshnessFallbackEnum = typeof ManifestEntryFreshnessFallbackEnum[keyof typeof ManifestEntryFreshnessFallbackEnum];
|
|
1242
|
+
/**
|
|
1243
|
+
* A reference to an already-materialized persist upstream that the built sources may read but which is not rebuilt in this run.
|
|
1244
|
+
* @export
|
|
1245
|
+
* @interface ManifestReference
|
|
1246
|
+
*/
|
|
1247
|
+
export interface ManifestReference {
|
|
1248
|
+
/**
|
|
1249
|
+
* The upstream\'s content id AS REPORTED BY THE PUBLISHER in PersistSourcePlan.sourceEntityId. It MUST equal what the compiler recomputes for the manifest lookup (mkBuildID over the upstream\'s manifest-ignorant SQL); do not substitute any other identity here.
|
|
1250
|
+
* @type {string}
|
|
1251
|
+
* @memberof ManifestReference
|
|
1252
|
+
*/
|
|
1253
|
+
'sourceEntityId': string;
|
|
1254
|
+
/**
|
|
1255
|
+
* Fully-qualified physical table the upstream currently serves.
|
|
1256
|
+
* @type {string}
|
|
1257
|
+
* @memberof ManifestReference
|
|
1258
|
+
*/
|
|
1259
|
+
'physicalTableName': string;
|
|
1260
|
+
}
|
|
1230
1261
|
/**
|
|
1231
1262
|
* A record of one materialization run for a package.
|
|
1232
1263
|
* @export
|
|
@@ -1774,6 +1805,18 @@ export interface PersistSourcePlan {
|
|
|
1774
1805
|
* @memberof PersistSourcePlan
|
|
1775
1806
|
*/
|
|
1776
1807
|
'refresh'?: string | null;
|
|
1808
|
+
/**
|
|
1809
|
+
*
|
|
1810
|
+
* @type {Freshness}
|
|
1811
|
+
* @memberof PersistSourcePlan
|
|
1812
|
+
*/
|
|
1813
|
+
'freshness'?: Freshness | null;
|
|
1814
|
+
/**
|
|
1815
|
+
* The source\'s EFFECTIVE power-tier cron after most-specific-wins resolution of the source\'s OWN declaration (source > model-file). The package-level cron (PackageMaterializationConfig.schedule) is a distinct package-grain concept and is NOT folded in here. Null = unset. Valid only when the source resolves to sharing=\"private\" (a cron on a shared or unset source is rejected at publish; declare freshness.window instead).
|
|
1816
|
+
* @type {string}
|
|
1817
|
+
* @memberof PersistSourcePlan
|
|
1818
|
+
*/
|
|
1819
|
+
'schedule'?: string | null;
|
|
1777
1820
|
/**
|
|
1778
1821
|
* Output schema of the source.
|
|
1779
1822
|
* @type {Array<Column>}
|