@sqlanvil/core 1.19.0 → 1.20.1

package/README.md

@@ -82,20 +82,22 @@ scripts/      ./scripts/run is the CLI entrypoint wrapper
 
 ## Building from source
 
-SQLAnvil uses [Bazel](https://bazel.build) (via Bazelisk). The recommended dev path on macOS is the Docker-based build container:
+SQLAnvil uses [Bazel](https://bazel.build) (via Bazelisk). Native Bazel works on macOS
+and Linux (Bazel 7 + bzlmod):
 
 ```bash
 # Build the proto layer
-./scripts/docker-bazel build //protos:sqlanvil_proto
+bazel build //protos:sqlanvil_proto
 
 # Run the CLI
-./scripts/docker-bazel run //packages/@sqlanvil/cli:bin -- help
+./scripts/run help
 
 # Run tests
-./scripts/docker-bazel test //...
+bazel test //core/... //cli/...
 ```
 
-See [contributing.md](contributing.md) for full instructions.
+A Docker-based build container (`./scripts/docker-bazel`) remains available as an
+optional hermetic environment. See [contributing.md](contributing.md) for full instructions.
 
 ---
 

package/bundle.d.ts

@@ -739,6 +739,9 @@ namespace sqlanvil {
 
         /** ActionConfig import */
         "import"?: (sqlanvil.ActionConfig.IImportConfig|null);
+
+        /** ActionConfig script */
+        script?: (sqlanvil.ActionConfig.IScriptConfig|null);
     }
 
     /** Represents an ActionConfig. */
@@ -792,8 +795,11 @@ namespace sqlanvil {
         /** ActionConfig import. */
         public import?: (sqlanvil.ActionConfig.IImportConfig|null);
 
+        /** ActionConfig script. */
+        public script?: (sqlanvil.ActionConfig.IScriptConfig|null);
+
         /** ActionConfig action. */
-        public action?: ("table"|"view"|"incrementalTable"|"assertion"|"operation"|"declaration"|"notebook"|"dataPreparation"|"rlsPolicy"|"realtimePublication"|"foreignWrapper"|"vectorIndex"|"export"|"import");
+        public action?: ("table"|"view"|"incrementalTable"|"assertion"|"operation"|"declaration"|"notebook"|"dataPreparation"|"rlsPolicy"|"realtimePublication"|"foreignWrapper"|"vectorIndex"|"export"|"import"|"script");
 
         /**
          * Creates a new ActionConfig instance using the specified properties.
@@ -3737,6 +3743,181 @@ namespace sqlanvil {
             }
         }
 
+        /** Properties of a ScriptConfig. */
+        interface IScriptConfig {
+
+            /** ScriptConfig name */
+            name?: (string|null);
+
+            /** ScriptConfig dataset */
+            dataset?: (string|null);
+
+            /** ScriptConfig project */
+            project?: (string|null);
+
+            /** ScriptConfig dependencyTargets */
+            dependencyTargets?: (sqlanvil.ActionConfig.ITarget[]|null);
+
+            /** ScriptConfig filename */
+            filename?: (string|null);
+
+            /** ScriptConfig tags */
+            tags?: (string[]|null);
+
+            /** ScriptConfig disabled */
+            disabled?: (boolean|null);
+
+            /** ScriptConfig description */
+            description?: (string|null);
+
+            /** ScriptConfig language */
+            language?: (string|null);
+
+            /** ScriptConfig args */
+            args?: (string[]|null);
+
+            /** ScriptConfig depsFile */
+            depsFile?: (string|null);
+
+            /** ScriptConfig runtimeVersion */
+            runtimeVersion?: (string|null);
+
+            /** ScriptConfig envRoot */
+            envRoot?: (string|null);
+
+            /** ScriptConfig timeoutMillis */
+            timeoutMillis?: (number|null);
+        }
+
+        /** Represents a ScriptConfig. */
+        class ScriptConfig implements IScriptConfig {
+
+            /**
+             * Constructs a new ScriptConfig.
+             * @param [properties] Properties to set
+             */
+            constructor(properties?: sqlanvil.ActionConfig.IScriptConfig);
+
+            /** ScriptConfig name. */
+            public name: string;
+
+            /** ScriptConfig dataset. */
+            public dataset: string;
+
+            /** ScriptConfig project. */
+            public project: string;
+
+            /** ScriptConfig dependencyTargets. */
+            public dependencyTargets: sqlanvil.ActionConfig.ITarget[];
+
+            /** ScriptConfig filename. */
+            public filename: string;
+
+            /** ScriptConfig tags. */
+            public tags: string[];
+
+            /** ScriptConfig disabled. */
+            public disabled: boolean;
+
+            /** ScriptConfig description. */
+            public description: string;
+
+            /** ScriptConfig language. */
+            public language: string;
+
+            /** ScriptConfig args. */
+            public args: string[];
+
+            /** ScriptConfig depsFile. */
+            public depsFile: string;
+
+            /** ScriptConfig runtimeVersion. */
+            public runtimeVersion: string;
+
+            /** ScriptConfig envRoot. */
+            public envRoot: string;
+
+            /** ScriptConfig timeoutMillis. */
+            public timeoutMillis: number;
+
+            /**
+             * Creates a new ScriptConfig instance using the specified properties.
+             * @param [properties] Properties to set
+             * @returns ScriptConfig instance
+             */
+            public static create(properties?: sqlanvil.ActionConfig.IScriptConfig): sqlanvil.ActionConfig.ScriptConfig;
+
+            /**
+             * Encodes the specified ScriptConfig message. Does not implicitly {@link sqlanvil.ActionConfig.ScriptConfig.verify|verify} messages.
+             * @param message ScriptConfig message or plain object to encode
+             * @param [writer] Writer to encode to
+             * @returns Writer
+             */
+            public static encode(message: sqlanvil.ActionConfig.IScriptConfig, writer?: $protobuf.Writer): $protobuf.Writer;
+
+            /**
+             * Encodes the specified ScriptConfig message, length delimited. Does not implicitly {@link sqlanvil.ActionConfig.ScriptConfig.verify|verify} messages.
+             * @param message ScriptConfig message or plain object to encode
+             * @param [writer] Writer to encode to
+             * @returns Writer
+             */
+            public static encodeDelimited(message: sqlanvil.ActionConfig.IScriptConfig, writer?: $protobuf.Writer): $protobuf.Writer;
+
+            /**
+             * Decodes a ScriptConfig message from the specified reader or buffer.
+             * @param reader Reader or buffer to decode from
+             * @param [length] Message length if known beforehand
+             * @returns ScriptConfig
+             * @throws {Error} If the payload is not a reader or valid buffer
+             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+             */
+            public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): sqlanvil.ActionConfig.ScriptConfig;
+
+            /**
+             * Decodes a ScriptConfig message from the specified reader or buffer, length delimited.
+             * @param reader Reader or buffer to decode from
+             * @returns ScriptConfig
+             * @throws {Error} If the payload is not a reader or valid buffer
+             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+             */
+            public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): sqlanvil.ActionConfig.ScriptConfig;
+
+            /**
+             * Verifies a ScriptConfig message.
+             * @param message Plain object to verify
+             * @returns `null` if valid, otherwise the reason why it is not
+             */
+            public static verify(message: { [k: string]: any }): (string|null);
+
+            /**
+             * Creates a ScriptConfig message from a plain object. Also converts values to their respective internal types.
+             * @param object Plain object
+             * @returns ScriptConfig
+             */
+            public static fromObject(object: { [k: string]: any }): sqlanvil.ActionConfig.ScriptConfig;
+
+            /**
+             * Creates a plain object from a ScriptConfig message. Also converts values to other types if specified.
+             * @param message ScriptConfig
+             * @param [options] Conversion options
+             * @returns Plain object
+             */
+            public static toObject(message: sqlanvil.ActionConfig.ScriptConfig, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+            /**
+             * Converts this ScriptConfig to JSON.
+             * @returns JSON object
+             */
+            public toJSON(): { [k: string]: any };
+
+            /**
+             * Gets the default type url for ScriptConfig
+             * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+             * @returns The default type url
+             */
+            public static getTypeUrl(typeUrlPrefix?: string): string;
+        }
+
         /** Properties of a RlsPolicyConfig. */
         interface IRlsPolicyConfig {
 
@@ -8686,6 +8867,187 @@ namespace sqlanvil {
         public static getTypeUrl(typeUrlPrefix?: string): string;
     }
 
+    /** Properties of a Script. */
+    interface IScript {
+
+        /** Script target */
+        target?: (sqlanvil.ITarget|null);
+
+        /** Script canonicalTarget */
+        canonicalTarget?: (sqlanvil.ITarget|null);
+
+        /** Script dependencyTargets */
+        dependencyTargets?: (sqlanvil.ITarget[]|null);
+
+        /** Script hermeticity */
+        hermeticity?: (sqlanvil.ActionHermeticity|null);
+
+        /** Script disabled */
+        disabled?: (boolean|null);
+
+        /** Script tags */
+        tags?: (string[]|null);
+
+        /** Script actionDescriptor */
+        actionDescriptor?: (sqlanvil.IActionDescriptor|null);
+
+        /** Script language */
+        language?: (string|null);
+
+        /** Script scriptFilename */
+        scriptFilename?: (string|null);
+
+        /** Script args */
+        args?: (string[]|null);
+
+        /** Script depsFile */
+        depsFile?: (string|null);
+
+        /** Script runtimeVersion */
+        runtimeVersion?: (string|null);
+
+        /** Script envRoot */
+        envRoot?: (string|null);
+
+        /** Script timeoutMillis */
+        timeoutMillis?: (number|null);
+
+        /** Script fileName */
+        fileName?: (string|null);
+    }
+
+    /** Represents a Script. */
+    class Script implements IScript {
+
+        /**
+         * Constructs a new Script.
+         * @param [properties] Properties to set
+         */
+        constructor(properties?: sqlanvil.IScript);
+
+        /** Script target. */
+        public target?: (sqlanvil.ITarget|null);
+
+        /** Script canonicalTarget. */
+        public canonicalTarget?: (sqlanvil.ITarget|null);
+
+        /** Script dependencyTargets. */
+        public dependencyTargets: sqlanvil.ITarget[];
+
+        /** Script hermeticity. */
+        public hermeticity: sqlanvil.ActionHermeticity;
+
+        /** Script disabled. */
+        public disabled: boolean;
+
+        /** Script tags. */
+        public tags: string[];
+
+        /** Script actionDescriptor. */
+        public actionDescriptor?: (sqlanvil.IActionDescriptor|null);
+
+        /** Script language. */
+        public language: string;
+
+        /** Script scriptFilename. */
+        public scriptFilename: string;
+
+        /** Script args. */
+        public args: string[];
+
+        /** Script depsFile. */
+        public depsFile: string;
+
+        /** Script runtimeVersion. */
+        public runtimeVersion: string;
+
+        /** Script envRoot. */
+        public envRoot: string;
+
+        /** Script timeoutMillis. */
+        public timeoutMillis: number;
+
+        /** Script fileName. */
+        public fileName: string;
+
+        /**
+         * Creates a new Script instance using the specified properties.
+         * @param [properties] Properties to set
+         * @returns Script instance
+         */
+        public static create(properties?: sqlanvil.IScript): sqlanvil.Script;
+
+        /**
+         * Encodes the specified Script message. Does not implicitly {@link sqlanvil.Script.verify|verify} messages.
+         * @param message Script message or plain object to encode
+         * @param [writer] Writer to encode to
+         * @returns Writer
+         */
+        public static encode(message: sqlanvil.IScript, writer?: $protobuf.Writer): $protobuf.Writer;
+
+        /**
+         * Encodes the specified Script message, length delimited. Does not implicitly {@link sqlanvil.Script.verify|verify} messages.
+         * @param message Script message or plain object to encode
+         * @param [writer] Writer to encode to
+         * @returns Writer
+         */
+        public static encodeDelimited(message: sqlanvil.IScript, writer?: $protobuf.Writer): $protobuf.Writer;
+
+        /**
+         * Decodes a Script message from the specified reader or buffer.
+         * @param reader Reader or buffer to decode from
+         * @param [length] Message length if known beforehand
+         * @returns Script
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): sqlanvil.Script;
+
+        /**
+         * Decodes a Script message from the specified reader or buffer, length delimited.
+         * @param reader Reader or buffer to decode from
+         * @returns Script
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): sqlanvil.Script;
+
+        /**
+         * Verifies a Script message.
+         * @param message Plain object to verify
+         * @returns `null` if valid, otherwise the reason why it is not
+         */
+        public static verify(message: { [k: string]: any }): (string|null);
+
+        /**
+         * Creates a Script message from a plain object. Also converts values to their respective internal types.
+         * @param object Plain object
+         * @returns Script
+         */
+        public static fromObject(object: { [k: string]: any }): sqlanvil.Script;
+
+        /**
+         * Creates a plain object from a Script message. Also converts values to other types if specified.
+         * @param message Script
+         * @param [options] Conversion options
+         * @returns Plain object
+         */
+        public static toObject(message: sqlanvil.Script, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+        /**
+         * Converts this Script to JSON.
+         * @returns JSON object
+         */
+        public toJSON(): { [k: string]: any };
+
+        /**
+         * Gets the default type url for Script
+         * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+         * @returns The default type url
+         */
+        public static getTypeUrl(typeUrlPrefix?: string): string;
+    }
+
     /** Properties of an Assertion. */
     interface IAssertion {
 
@@ -10090,6 +10452,9 @@ namespace sqlanvil {
         /** CompiledGraph extracts */
         extracts?: (sqlanvil.IExtract[]|null);
 
+        /** CompiledGraph scripts */
+        scripts?: (sqlanvil.IScript[]|null);
+
         /** CompiledGraph graphErrors */
         graphErrors?: (sqlanvil.IGraphErrors|null);
 
@@ -10145,6 +10510,9 @@ namespace sqlanvil {
         /** CompiledGraph extracts. */
         public extracts: sqlanvil.IExtract[];
 
+        /** CompiledGraph scripts. */
+        public scripts: sqlanvil.IScript[];
+
         /** CompiledGraph graphErrors. */
         public graphErrors?: (sqlanvil.IGraphErrors|null);
 
@@ -12291,6 +12659,139 @@ namespace sqlanvil {
         public static getTypeUrl(typeUrlPrefix?: string): string;
     }
 
+    /** Properties of a ScriptSpec. */
+    interface IScriptSpec {
+
+        /** ScriptSpec language */
+        language?: (string|null);
+
+        /** ScriptSpec filename */
+        filename?: (string|null);
+
+        /** ScriptSpec args */
+        args?: (string[]|null);
+
+        /** ScriptSpec depsFile */
+        depsFile?: (string|null);
+
+        /** ScriptSpec runtimeVersion */
+        runtimeVersion?: (string|null);
+
+        /** ScriptSpec envRoot */
+        envRoot?: (string|null);
+
+        /** ScriptSpec timeoutMillis */
+        timeoutMillis?: (number|null);
+    }
+
+    /** Represents a ScriptSpec. */
+    class ScriptSpec implements IScriptSpec {
+
+        /**
+         * Constructs a new ScriptSpec.
+         * @param [properties] Properties to set
+         */
+        constructor(properties?: sqlanvil.IScriptSpec);
+
+        /** ScriptSpec language. */
+        public language: string;
+
+        /** ScriptSpec filename. */
+        public filename: string;
+
+        /** ScriptSpec args. */
+        public args: string[];
+
+        /** ScriptSpec depsFile. */
+        public depsFile: string;
+
+        /** ScriptSpec runtimeVersion. */
+        public runtimeVersion: string;
+
+        /** ScriptSpec envRoot. */
+        public envRoot: string;
+
+        /** ScriptSpec timeoutMillis. */
+        public timeoutMillis: number;
+
+        /**
+         * Creates a new ScriptSpec instance using the specified properties.
+         * @param [properties] Properties to set
+         * @returns ScriptSpec instance
+         */
+        public static create(properties?: sqlanvil.IScriptSpec): sqlanvil.ScriptSpec;
+
+        /**
+         * Encodes the specified ScriptSpec message. Does not implicitly {@link sqlanvil.ScriptSpec.verify|verify} messages.
+         * @param message ScriptSpec message or plain object to encode
+         * @param [writer] Writer to encode to
+         * @returns Writer
+         */
+        public static encode(message: sqlanvil.IScriptSpec, writer?: $protobuf.Writer): $protobuf.Writer;
+
+        /**
+         * Encodes the specified ScriptSpec message, length delimited. Does not implicitly {@link sqlanvil.ScriptSpec.verify|verify} messages.
+         * @param message ScriptSpec message or plain object to encode
+         * @param [writer] Writer to encode to
+         * @returns Writer
+         */
+        public static encodeDelimited(message: sqlanvil.IScriptSpec, writer?: $protobuf.Writer): $protobuf.Writer;
+
+        /**
+         * Decodes a ScriptSpec message from the specified reader or buffer.
+         * @param reader Reader or buffer to decode from
+         * @param [length] Message length if known beforehand
+         * @returns ScriptSpec
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): sqlanvil.ScriptSpec;
+
+        /**
+         * Decodes a ScriptSpec message from the specified reader or buffer, length delimited.
+         * @param reader Reader or buffer to decode from
+         * @returns ScriptSpec
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): sqlanvil.ScriptSpec;
+
+        /**
+         * Verifies a ScriptSpec message.
+         * @param message Plain object to verify
+         * @returns `null` if valid, otherwise the reason why it is not
+         */
+        public static verify(message: { [k: string]: any }): (string|null);
+
+        /**
+         * Creates a ScriptSpec message from a plain object. Also converts values to their respective internal types.
+         * @param object Plain object
+         * @returns ScriptSpec
+         */
+        public static fromObject(object: { [k: string]: any }): sqlanvil.ScriptSpec;
+
+        /**
+         * Creates a plain object from a ScriptSpec message. Also converts values to other types if specified.
+         * @param message ScriptSpec
+         * @param [options] Conversion options
+         * @returns Plain object
+         */
+        public static toObject(message: sqlanvil.ScriptSpec, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+        /**
+         * Converts this ScriptSpec to JSON.
+         * @returns JSON object
+         */
+        public toJSON(): { [k: string]: any };
+
+        /**
+         * Gets the default type url for ScriptSpec
+         * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+         * @returns The default type url
+         */
+        public static getTypeUrl(typeUrlPrefix?: string): string;
+    }
+
     /** Properties of an ExecutionAction. */
     interface IExecutionAction {
 
@@ -12329,6 +12830,9 @@ namespace sqlanvil {
 
         /** ExecutionAction extract */
         extract?: (sqlanvil.IExtractSpec|null);
+
+        /** ExecutionAction script */
+        script?: (sqlanvil.IScriptSpec|null);
     }
 
     /** Represents an ExecutionAction. */
@@ -12376,6 +12880,9 @@ namespace sqlanvil {
         /** ExecutionAction extract. */
         public extract?: (sqlanvil.IExtractSpec|null);
 
+        /** ExecutionAction script. */
+        public script?: (sqlanvil.IScriptSpec|null);
+
         /**
          * Creates a new ExecutionAction instance using the specified properties.
          * @param [properties] Properties to set
@@ -15937,6 +16444,22 @@ declare class OperationContext implements IActionContext {
     apply<T>(value: Contextable<IActionContext, T>): T;
 }
 
+declare class Script extends ActionBuilder<sqlanvil.Script> {
+    session: Session;
+    dependOnDependencyAssertions: boolean;
+    private proto;
+    constructor(session?: Session, unverifiedConfig?: any, configPath?: string, projectFiles?: string[]);
+    dependencies(value: Resolvable | Resolvable[]): this;
+    disabled(disabled?: boolean): this;
+    tags(value: string | string[]): this;
+    description(description: string): this;
+    getFileName(): string;
+    getTarget(): sqlanvil.Target;
+    compile(): sqlanvil.Script;
+    private checkConfig;
+    private verifyConfig;
+}
+
 interface ITestConfig extends INamedConfig {
     dataset?: Resolvable;
     name?: string;
@@ -16133,7 +16656,7 @@ interface IRecordDescriptor {
     bigqueryPolicyTags?: string | string[];
 }
 
-declare type Action = Table | View | IncrementalTable | Operation | Assertion | Declaration | Notebook | DataPreparation | Export | Extract | Import | Test | RlsPolicy | RealtimePublication | Wrapper | ForeignTable | VectorIndex;
+declare type Action = Table | View | IncrementalTable | Operation | Assertion | Declaration | Notebook | DataPreparation | Export | Extract | Import | Script | Test | RlsPolicy | RealtimePublication | Wrapper | ForeignTable | VectorIndex;
 interface INamedConfig {
     type?: string;
     name?: string;
@@ -16290,7 +16813,7 @@ declare function jitCompiler(rpcCallback: RpcCallback): IJitCompiler;
 
 declare function main(coreExecutionRequest: Uint8Array | string): Uint8Array | string;
 
-declare const version = "1.19.0";
+declare const version = "1.20.1";
 
 declare const session: Session;
 declare const supportedFeatures: sqlanvil.SupportedFeatures[];