cdk-glue-iceberg-table 0.7.4 → 0.8.0

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/.jsii CHANGED
@@ -9751,7 +9751,7 @@
9751
9751
  },
9752
9752
  "name": "cdk-glue-iceberg-table",
9753
9753
  "readme": {
9754
- "markdown": "# cdk-glue-iceberg-table\n\n[![CI](https://img.shields.io/github/actions/workflow/status/ksco92/arceus/ci.yml?branch=main&label=CI)](https://github.com/ksco92/arceus/actions/workflows/ci.yml)\n[![coverage](https://codecov.io/gh/ksco92/arceus/branch/main/graph/badge.svg)](https://codecov.io/gh/ksco92/arceus)\n[![npm](https://img.shields.io/npm/v/cdk-glue-iceberg-table.svg)](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[![PyPI](https://img.shields.io/pypi/v/cdk-glue-iceberg-table.svg)](https://pypi.org/project/cdk-glue-iceberg-table/)\n[![Construct Hub](https://img.shields.io/badge/Construct%20Hub-available-blueviolet)](https://constructs.dev/packages/cdk-glue-iceberg-table)\n[![types](https://img.shields.io/npm/types/cdk-glue-iceberg-table.svg)](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[![downloads](https://img.shields.io/npm/dw/cdk-glue-iceberg-table.svg)](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[![last commit](https://img.shields.io/github/last-commit/ksco92/arceus.svg)](https://github.com/ksco92/arceus/commits/main)\n[![license](https://img.shields.io/npm/l/cdk-glue-iceberg-table.svg)](https://github.com/ksco92/arceus/blob/main/LICENSE)\n\n**`cdk-glue-iceberg-table` is the AWS CDK L2 construct for creating\nand evolving Apache Iceberg tables in the AWS Glue Data Catalog.** It\nemits the exact `AWS::Glue::Table` / `OpenTableFormatInput` shape that\nsurvives a CloudFormation `Update`, so a single `cdk deploy` creates a\ntable, evolves its schema and partitions, and destroys it, the same\nlifecycle CDK gives any other resource. No custom resource, no Lambda,\nno \"`cdk deploy` and then run this SQL by hand\" two-step. Table\nchanges (new columns, renames, drops, new partition fields) land as\na reviewed diff in a pull request and apply through `cdk deploy`.\n\nStatus (October 2026): published on npm (TypeScript/JavaScript) and PyPI\n(Python), pre-1.0, with a public surface guarded by an end-to-end\nconsumer test on every PR plus three real-AWS integration suites. The\nmulti-language packages are generated from one TypeScript source with\n[jsii](https://aws.github.io/jsii/) and indexed on\n[Construct Hub](https://constructs.dev/packages/cdk-glue-iceberg-table).\nDeveloped in the\n[`ksco92/arceus`](https://github.com/ksco92/arceus) monorepo, which\nalso holds a CDK demo app that dogfoods the construct against a real\nAWS account.\n\n### Why this exists\n\nAWS documents the CloudFormation shape for Iceberg tables ([AWS Big\nData blog, December 2025](https://aws.amazon.com/blogs/big-data/create-and-update-apache-iceberg-tables-with-partitions-in-the-aws-glue-data-catalog-using-the-aws-sdk-and-aws-cloudformation)),\nbut raw `AWS::Glue::Table` is a minefield: the CREATE succeeds and the\n*first* `Update` silently strips `table_type=ICEBERG`, after which\nevery Athena query fails with `HIVE_UNSUPPORTED_FORMAT`. The\nmotivating CDK issue is [aws/aws-cdk#29660](https://github.com/aws/aws-cdk/issues/29660);\n[`manmartgarc`'s comment](https://github.com/aws/aws-cdk/issues/29660#issuecomment-4411359248)\ndocuments the only working shape and the silent-corruption traps you\nhit by getting it slightly wrong. This construct implements that\nshape, refuses to emit the unsafe alternatives, and pins Iceberg field\nIDs so schema evolution never orphans existing data. It was the basis\nof an upstream proposal to land an `IcebergTable` in\n`@aws-cdk/aws-glue-alpha` ([aws/aws-cdk#37988](https://github.com/aws/aws-cdk/pull/37988)),\nclosed unmerged in September 2026.\n\n### How it compares\n\n| Approach | Declarative IaC (in the PR) | In-place schema + partition evolution | Prevents the silent-corruption footguns | Typed API + synth-time validation |\n| --- | --- | --- | --- | --- |\n| Raw `CfnTable` (L1) | ✅ | ⚠️ only if you hand-write the exact `OpenTableFormatInput` shape | ❌ you own both footguns | ❌ |\n| CDK custom resource (Lambda + Glue SDK) | ⚠️ via a custom resource you maintain | ⚠️ you write the diff logic | ⚠️ your code's responsibility | ❌ |\n| Spark / Athena SQL DDL at job runtime | ❌ imperative, outside the PR | ✅ but outside CloudFormation | n/a | ❌ |\n| **`cdk-glue-iceberg-table`** | ✅ | ✅ via `cdk deploy` | ✅ both prevented by construction | ✅ |\n\n## Install\n\nTypeScript / JavaScript (npm):\n\n```bash\nnpm install cdk-glue-iceberg-table\n```\n\nPython (PyPI):\n\n```bash\npip install cdk-glue-iceberg-table\n```\n\nPeer dependencies (your CDK app must already have these). This\nrelease requires `aws-cdk-lib` 2.273.0 or newer and `constructs`\n10.8.1 or newer, plus Node.js 22.14 or newer for both languages (the\nPython package runs under Node.js through jsii).\n\nFor TypeScript / JavaScript:\n\n```bash\nnpm install aws-cdk-lib@^2.273.0 constructs@^10.8.1\n```\n\nFor Python:\n\n```bash\npip install 'aws-cdk-lib>=2.273.0' 'constructs>=10.8.1'\n```\n\n## Use\n\n### TypeScript\n\n```ts\nimport { Bucket } from 'aws-cdk-lib/aws-s3';\nimport { Database } from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n IcebergPartitionTransform,\n} from 'cdk-glue-iceberg-table';\n\nconst bucket = new Bucket(this, 'Warehouse');\nconst db = new Database(this, 'Db', { databaseName: 'analytics' });\n\nnew IcebergTable(this, 'OrdersTable', {\n database: db,\n tableName: 'orders',\n location: `s3://${bucket.bucketName}/analytics/orders/`,\n columns: [\n { name: 'order_id', type: IcebergType.LONG, required: true, id: 1 },\n { name: 'customer_id', type: IcebergType.LONG, required: true, id: 2 },\n { name: 'placed_at', type: IcebergType.TIMESTAMPTZ, required: true, id: 3 },\n ],\n partitionSpec: [\n { sourceColumn: 'placed_at', transform: IcebergPartitionTransform.DAY, fieldId: 1000 },\n { sourceColumn: 'customer_id', transform: IcebergPartitionTransform.bucket(16), fieldId: 1001 },\n ],\n identifierFieldNames: ['order_id'],\n formatVersion: IcebergFormatVersion.V2,\n});\n```\n\n### Python\n\nThe same table in Python — the API mirrors TypeScript with\n`snake_case` props and `PascalCase` types:\n\n```python\nfrom aws_cdk.aws_s3 import Bucket\nfrom aws_cdk.aws_glue import Database\nfrom cdk_glue_iceberg_table import (\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n IcebergPartitionTransform,\n)\n\nbucket = Bucket(self, \"Warehouse\")\ndb = Database(self, \"Db\", database_name=\"analytics\")\n\nIcebergTable(self, \"OrdersTable\",\n database=db,\n table_name=\"orders\",\n location=f\"s3://{bucket.bucket_name}/analytics/orders/\",\n columns=[\n {\"name\": \"order_id\", \"type\": IcebergType.LONG, \"required\": True, \"id\": 1},\n {\"name\": \"customer_id\", \"type\": IcebergType.LONG, \"required\": True, \"id\": 2},\n {\"name\": \"placed_at\", \"type\": IcebergType.TIMESTAMPTZ, \"required\": True, \"id\": 3},\n ],\n partition_spec=[\n {\"source_column\": \"placed_at\", \"transform\": IcebergPartitionTransform.DAY, \"field_id\": 1000},\n {\"source_column\": \"customer_id\", \"transform\": IcebergPartitionTransform.bucket(16), \"field_id\": 1001},\n ],\n identifier_field_names=[\"order_id\"],\n format_version=IcebergFormatVersion.V2,\n)\n```\n\nConsumer-facing reference sections:\n\n- [How it compares](#how-it-compares) — `cdk-glue-iceberg-table` vs raw `CfnTable`, custom resources, and runtime SQL DDL.\n- [Using `IcebergTable`](#using-icebergtable) — full API reference with examples.\n- [Two footguns the construct prevents](#two-footguns-the-construct-prevents) — the silent-corruption traps that motivated this construct.\n- [Known limitations](#known-limitations) — what the construct does and doesn't enforce.\n- [FAQ](#faq) — common \"how do I … in CDK / CloudFormation\" questions.\n\n## Exported surface\n\nThe package entry point re-exports everything you import from\n`cdk-glue-iceberg-table`. In TypeScript / JavaScript the compiled\nsurface lives under `dist/lib/iceberg/` after `npm install`; in Python\nthe same surface is imported from the `cdk_glue_iceberg_table` module\nafter `pip install`:\n\n- **`IcebergTable`** — the L2 construct itself, with `grantRead` / `grantWrite` / `grantReadWrite` and the `fromIcebergTableAttributes(...)` import factory.\n- **`IcebergType`** — primitive types plus `list` / `map` / `struct` / `decimal` / `fixed` factories. Renders to the JSON shape Glue's `IcebergStructField.type` expects.\n- **`IcebergPartitionTransform`** — identity / `bucket(N)` / `truncate(W)` / year / month / day / hour / void. Each transform validates against the source column type at synth time.\n- **`IcebergDataFormat`** (parquet/orc/avro, default parquet), **`IcebergFormatVersion`** (v1/v2, required — set explicitly per table), **`IcebergSortDirection`**, **`IcebergNullOrder`**, plus a `tableProperties` validator that catches misconfigured properties before they leave your machine (wrong codec for the chosen format, `merge-on-read` on a v1 table, non-positive numeric values, …).\n\n## Using `IcebergTable`\n\nA minimal table:\n\n```typescript\nimport {\n Bucket,\n} from 'aws-cdk-lib/aws-s3';\nimport {\n Database,\n} from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n} from 'cdk-glue-iceberg-table';\n\nconst bucket = new Bucket(this, 'Warehouse');\n\nconst db = new Database(this, 'Db', {\n databaseName: 'analytics',\n});\n\nnew IcebergTable(this, 'Users', {\n database: db,\n tableName: 'users',\n columns: [\n {\n name: 'user_id',\n type: IcebergType.LONG,\n required: true,\n id: 1,\n },\n {\n name: 'email',\n type: IcebergType.STRING,\n required: true,\n id: 2,\n },\n {\n name: 'signed_up_at',\n type: IcebergType.TIMESTAMPTZ,\n required: true,\n id: 3,\n },\n ],\n location: `s3://${bucket.bucketName}/analytics/users/`,\n formatVersion: IcebergFormatVersion.V2,\n});\n```\n\nEvery top-level column must declare an `id`: a stable, unique,\npositive integer you pick once and never reuse or reassign. Because\nIceberg data files reference fields by id rather than by name, a fixed\nid is what lets you add, rename, and drop columns across deploys\nwithout corrupting old data — see\n[How do I evolve an Iceberg table schema](#how-do-i-evolve-an-iceberg-table-schema-add-rename-or-drop-a-column-in-cloudformation).\nOnce a column is dropped, leave its id retired; never hand it to a new\ncolumn. (Nested struct/list/map field ids are assigned automatically\nabove the highest top-level id — only top-level column ids are\ncaller-provided.)\n\nA table that exercises most of the surface (partitions, sort order,\nnested types, identifier fields, table properties, removal policy):\n\n```typescript\nimport {\n RemovalPolicy,\n} from 'aws-cdk-lib';\nimport {\n Database,\n} from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergDataFormat,\n IcebergFormatVersion,\n IcebergNullOrder,\n IcebergPartitionTransform,\n IcebergSortDirection,\n IcebergTable,\n IcebergType,\n} from 'cdk-glue-iceberg-table';\n\nnew IcebergTable(this, 'OrdersTable', {\n database: db,\n tableName: 'orders',\n comment: 'Demo Iceberg orders table — exercises partitions, sort order, and merge-on-read.',\n columns: [\n {\n name: 'order_id',\n type: IcebergType.LONG,\n required: true,\n id: 1,\n },\n {\n name: 'customer_id',\n type: IcebergType.LONG,\n required: true,\n id: 2,\n },\n {\n name: 'order_amount',\n type: IcebergType.decimal(12, 2),\n required: true,\n id: 3,\n },\n {\n name: 'currency',\n type: IcebergType.STRING,\n required: true,\n id: 4,\n },\n {\n name: 'placed_at',\n type: IcebergType.TIMESTAMPTZ,\n required: true,\n id: 5,\n },\n {\n name: 'tags',\n type: IcebergType.list(IcebergType.STRING),\n id: 6,\n },\n {\n name: 'shipping_address',\n type: IcebergType.struct([\n {\n name: 'line1',\n type: IcebergType.STRING,\n required: true,\n },\n {\n name: 'city',\n type: IcebergType.STRING,\n required: true,\n },\n {\n name: 'country',\n type: IcebergType.STRING,\n required: true,\n },\n {\n name: 'postal_code',\n type: IcebergType.STRING,\n },\n ]),\n id: 7,\n },\n {\n name: 'metadata',\n type: IcebergType.map(IcebergType.STRING, IcebergType.STRING, false),\n id: 8,\n },\n ],\n location: `s3://${bucket.bucketName}/analytics/orders/`,\n partitionSpec: [\n {\n sourceColumn: 'placed_at',\n transform: IcebergPartitionTransform.DAY,\n fieldId: 1000,\n },\n {\n sourceColumn: 'customer_id',\n transform: IcebergPartitionTransform.bucket(16),\n fieldId: 1001,\n },\n ],\n sortOrder: [\n {\n sourceColumn: 'placed_at',\n direction: IcebergSortDirection.ASC,\n nullOrder: IcebergNullOrder.NULLS_LAST,\n },\n {\n sourceColumn: 'order_id',\n direction: IcebergSortDirection.ASC,\n },\n ],\n identifierFieldNames: [\n 'order_id',\n ],\n dataFormat: IcebergDataFormat.PARQUET,\n formatVersion: IcebergFormatVersion.V2,\n tableProperties: {\n 'write.parquet.compression-codec': 'zstd',\n 'write.delete.mode': 'merge-on-read',\n 'write.update.mode': 'merge-on-read',\n 'write.merge.mode': 'merge-on-read',\n 'write.target-file-size-bytes': '134217728',\n 'history.expire.min-snapshots-to-keep': '5',\n 'gc.enabled': 'true',\n },\n removalPolicy: RemovalPolicy.DESTROY,\n});\n```\n\nEach partition field also pins a `fieldId`: an integer of 1000 or\nabove (the Iceberg spec reserves lower ids for schema columns), unique\nacross the table's entire partition-spec history. The discipline is\nthe inverse of the column-id rule. A column keeps its id forever; a\npartition field keeps its id only while it stays untouched. Change\nanything about a field — swap `month` for `day`, point it at a\ndifferent source column — and it becomes a *new* field that needs a\nfresh, never-before-used id, while the old id retires with the old\nspec. Reusing a retired id (or reassigning an id to a different field)\nproduces a table that Athena still reads but Spark and Trino reject\nwith `ValidationException: Conflicting partition fields`.\n\nThe resulting Iceberg `metadata.json` for this table contains every\nfeature you set:\n\n```json\n{\n \"format-version\": 2,\n \"table-uuid\": \"39a948f9-...\",\n \"current-schema-id\": 0,\n \"schemas\": [\n {\n \"schema-id\": 0,\n \"identifier-field-ids\": [1],\n \"fields\": [\n { \"id\": 1, \"name\": \"order_id\", \"required\": true, \"type\": \"long\" },\n { \"id\": 2, \"name\": \"customer_id\", \"required\": true, \"type\": \"long\" },\n { \"id\": 3, \"name\": \"order_amount\", \"required\": true, \"type\": \"decimal(12, 2)\" },\n { \"id\": 4, \"name\": \"currency\", \"required\": true, \"type\": \"string\" },\n { \"id\": 5, \"name\": \"placed_at\", \"required\": true, \"type\": \"timestamptz\" },\n { \"id\": 6, \"name\": \"tags\", \"required\": false,\n \"type\": { \"type\": \"list\", \"element-id\": 9, \"element\": \"string\", \"element-required\": true } },\n { \"id\": 7, \"name\": \"shipping_address\", \"required\": false,\n \"type\": { \"type\": \"struct\", \"fields\": [\n { \"id\": 10, \"name\": \"line1\", \"required\": true, \"type\": \"string\" },\n { \"id\": 11, \"name\": \"city\", \"required\": true, \"type\": \"string\" },\n { \"id\": 12, \"name\": \"country\", \"required\": true, \"type\": \"string\" },\n { \"id\": 13, \"name\": \"postal_code\", \"required\": false, \"type\": \"string\" }\n ] } },\n { \"id\": 8, \"name\": \"metadata\", \"required\": false,\n \"type\": { \"type\": \"map\", \"key-id\": 14, \"key\": \"string\", \"value-id\": 15,\n \"value-required\": false, \"value\": \"string\" } }\n ]\n }\n ],\n \"partition-specs\": [\n { \"spec-id\": 0, \"fields\": [\n { \"name\": \"placed_at_day\", \"transform\": \"day\", \"source-id\": 5, \"field-id\": 1000 },\n { \"name\": \"customer_id_bucket\", \"transform\": \"bucket[16]\", \"source-id\": 2, \"field-id\": 1001 }\n ]}\n ],\n \"sort-orders\": [\n { \"order-id\": 1, \"fields\": [\n { \"transform\": \"identity\", \"source-id\": 5, \"direction\": \"asc\", \"null-order\": \"nulls-last\" },\n { \"transform\": \"identity\", \"source-id\": 1, \"direction\": \"asc\", \"null-order\": \"nulls-last\" }\n ]}\n ],\n \"properties\": {\n \"format-version\": \"2\",\n \"write.format.default\": \"parquet\",\n \"write.parquet.compression-codec\": \"zstd\",\n \"write.merge.mode\": \"merge-on-read\",\n \"write.update.mode\": \"merge-on-read\",\n \"write.delete.mode\": \"merge-on-read\",\n \"write.target-file-size-bytes\": \"134217728\",\n \"history.expire.min-snapshots-to-keep\": \"5\",\n \"gc.enabled\": \"true\",\n \"comment\": \"Demo Iceberg orders table — exercises partitions, sort order, and merge-on-read.\"\n }\n}\n```\n\n### Granting access\n\n```typescript\ntable.grantRead(role); // Glue read + S3 read on the table's prefix\ntable.grantWrite(role); // Glue write + S3 write\ntable.grantReadWrite(role);\n```\n\nThe `grant*` helpers issue **IAM grants only**. Under Lake Formation\nyou still add the matching `SELECT` / `INSERT` / `DELETE` LF grants on\ntop of the construct's IAM grants for Athena queries to succeed.\n\n### Importing an existing table\n\n```typescript\nconst existing = IcebergTable.fromIcebergTableAttributes(this, 'Orders', {\n database: db,\n tableName: 'orders',\n location: 's3://my-bucket/analytics/orders/',\n});\nexisting.grantRead(role);\n```\n\n### Evolving schema and partitions\n\nChange the `columns` array (or `partitionSpec`) and run `cdk deploy`\nagain. The construct passes the new schema to Glue's `UpdateTable`,\nwhich writes a new `metadata.json` with a new `schema-id`; existing\ndata files stay readable because each column's `id` is pinned and\nnever reused. Adds, renames (same `id`, new `name`), and drops all\nflow through `cdk deploy` alone — no out-of-band SQL DDL.\n\nPartition evolution flows the same way, with one extra rule on\n`fieldId`: a changed partition field is a new partition field. To move\na table from `month(placed_at)` to `day(placed_at)`, drop the month\nentry and add a day entry under a fresh `fieldId` — never recycle the\nmonth field's id:\n\n```typescript\npartitionSpec: [\n // was: { sourceColumn: 'placed_at', transform: IcebergPartitionTransform.MONTH, fieldId: 1000 },\n {\n sourceColumn: 'placed_at',\n transform: IcebergPartitionTransform.DAY,\n fieldId: 1001,\n },\n],\n```\n\nOld data files written under the month spec stay readable; new writes\npartition by day. Reusing `1000` for the day field instead corrupts\nthe spec history for strict engines (Spark, Trino) while Athena keeps\nworking — the failure only surfaces at Spark runtime.\n\n### Inserting and querying\n\n```sql\n-- INSERT into the orders table\nINSERT INTO sample_database.orders VALUES\n (1001, 5001, DECIMAL '149.99', 'USD',\n TIMESTAMP '2026-05-20 09:15:00 UTC',\n ARRAY['holiday-promo','first-order'],\n CAST(ROW('1 Infinite Loop','Cupertino','US','95014')\n AS ROW(line1 VARCHAR,city VARCHAR,country VARCHAR,postal_code VARCHAR)),\n MAP(ARRAY['channel','utm'], ARRAY['web','google'])),\n -- ... more rows\n;\n\n-- merge-on-read DELETE (only legal because we chose v2 + merge-on-read mode)\nDELETE FROM sample_database.orders WHERE order_id = 1003;\n\n-- merge-on-read UPDATE\nUPDATE sample_database.orders SET currency = 'GBP' WHERE customer_id = 5002;\n\n-- SELECT\nSELECT customer_id, SUM(order_amount) AS total\n FROM sample_database.orders\n GROUP BY 1\n ORDER BY 2 DESC;\n```\n\n## Two footguns the construct prevents\n\n### Footgun #1 — schema under `storageDescriptor.columns`\n\nThe CREATE succeeds but the first UPDATE silently strips\n`table_type=ICEBERG` from the table's Glue parameters, and Athena\nqueries after that fail with `HIVE_UNSUPPORTED_FORMAT`.\n\n```typescript\n// DON'T DO THIS — what most StackOverflow / re:Post examples show\nnew CfnTable(this, 'OrdersBad', {\n catalogId: this.account,\n databaseName: 'analytics',\n tableInput: {\n name: 'orders',\n tableType: 'EXTERNAL_TABLE',\n parameters: {\n table_type: 'ICEBERG',\n },\n storageDescriptor: {\n location: 's3://.../orders/',\n columns: [\n /* ... */\n ],\n },\n },\n openTableFormatInput: {\n icebergInput: {\n metadataOperation: 'CREATE',\n version: '2',\n },\n },\n});\n```\n\n`IcebergTable` instead always emits schema/partitions/sort/properties\nunder `openTableFormatInput.icebergInput.icebergTableInput`, never\nunder `storageDescriptor`.\n\n### Footgun #2 — `tableInput` co-present with `openTableFormatInput`\n\nEven setting just `tableInput: { name: 'foo' }` next to\n`openTableFormatInput` returns\n`\"Table metadata is expected only via TableInput or via IcebergTableInputProperties inside OpenTableFormatInput\"`.\nThe construct never emits `tableInput`; the table-level comment goes\ninto `tableProperties['comment']`, which lives inside\n`icebergTableInput.properties`.\n\n(There is a third footgun, field-id reuse after a column drop, that\nthe construct does **not** prevent. See the next section.)\n\n## Known limitations\n\n- **Field-id reuse is not detected across deploys.** If you drop a column with `id = 5` and then add a different column with `id = 5` in a later deploy, Glue accepts the UPDATE and Iceberg's metadata silently violates the \"never reuse a retired id\" invariant. Readers projecting old snapshots will surface deleted data under the new field's name. The construct enforces uniqueness **within one deploy** (`duplicate column id N` validator), but it doesn't compare against the live table state. The safe workflow is to always pin `id` explicitly and treat dropped ids as retired forever; never let CDK reassign an id that has ever been used.\n- **Partition field-id reuse is not detected across deploys either.** The same live-state blindness applies to partition `fieldId`s: the construct validates them within one deploy (integer >= 1000, unique in the spec), but it cannot tell that the id you pinned already appeared in an earlier spec of the deployed table. The invariant partition ids must uphold is stricter than the column one — unique across the table's **entire spec history**, so a changed field (different transform or source column) must take a fresh id rather than keep its old one. Violate it and strict engines (Spark, Trino) reject the table with `Conflicting partition fields` while Athena keeps answering, masking the break until Spark runtime. The safe workflow: treat every id that has ever appeared in any spec as retired, and allocate new fields the next never-used id.\n- **`last-partition-id` is written by Glue, not by the construct.** The construct supplies the spec's field ids; Glue's `UpdateTable` computes the table's `last-partition-id` counter when it writes the new metadata. The repo's integration test asserts the counter keeps up with the highest supplied field id after a partition evolution, but engines that later evolve the spec themselves (e.g. Spark `ALTER TABLE … ADD PARTITION FIELD`) allocate from that counter — if you mix CDK-managed and engine-managed partition evolution, verify the counter in `metadata.json` before trusting engine-side changes.\n- **CREATE-only metadata operation.** The CFN `IcebergInput.metadataOperation` only accepts `CREATE`; the construct always emits that. Subsequent deploys use Glue's normal `UpdateTable` path, which writes new Iceberg metadata in-place.\n- **Format version is immutable after CREATE.** The `formatVersion` prop is read once at table creation; changing it later requires a destroy + recreate.\n- **`merge-on-read` requires v2.** The construct rejects `write.{delete,update,merge}.mode = merge-on-read` on a v1 table at synth time.\n- **Athena DDL features that don't surface through CFN** (e.g. `ALTER TABLE WRITE ORDERED BY`, `ALTER TABLE … SET LOCATION`, `bucketed_by` / `bucket_count` Hive clauses) are not exposed. Use `IcebergPartitionTransform.bucket(N)` instead of Hive bucketing.\n- **Dropping a partition column requires a `void` intermediate per the Iceberg spec**, and the CFN `OpenTableFormatInput` cannot express that. The construct accepts the change, but Athena queries against the result will fail with `Type cannot be null`. The safe pattern is to drop partitions that source from a column while keeping that column in the schema, and only drop a column once it is no longer partitioning anything.\n\n## FAQ\n\n### How do I create an Apache Iceberg table in AWS CDK?\n\nInstall `cdk-glue-iceberg-table`, then declare an `IcebergTable` with a\ndatabase, a column list, and an S3 `location` — see [Use](#use).\n`cdk deploy` creates the Glue Data Catalog table and writes the\nIceberg `metadata.json` under your S3 prefix. No custom resource or\nLambda is involved; it is a plain `AWS::Glue::Table` in your\nCloudFormation template.\n\n### How do I evolve an Iceberg table schema (add, rename, or drop a column) in CloudFormation?\n\nChange the `columns` array and run `cdk deploy` again. The construct\npasses the new schema to Glue's `UpdateTable`, which writes a new\n`metadata.json` with a new `schema-id`; existing data files stay\nreadable because each column's `id` is pinned and never reused.\nPartition changes work the same way, except a changed partition field\ntakes a fresh `fieldId` instead of keeping its old one. See [Evolving\nschema and partitions](#evolving-schema-and-partitions).\n\n### Does CloudFormation support Iceberg tables natively?\n\nYes, through `AWS::Glue::Table` with `OpenTableFormatInput.IcebergInput`,\ndocumented by AWS in [December 2025](https://aws.amazon.com/blogs/big-data/create-and-update-apache-iceberg-tables-with-partitions-in-the-aws-glue-data-catalog-using-the-aws-sdk-and-aws-cloudformation).\nThe catch is that the raw shape corrupts the table on the first\n`Update` if you place schema under `storageDescriptor.columns` or set\n`tableInput` alongside `openTableFormatInput`. This construct only ever\nemits the safe shape and gives you no way to express the unsafe ones.\nSee [Two footguns the construct prevents](#two-footguns-the-construct-prevents).\n\n### What is the difference between cdk-glue-iceberg-table and a raw CfnTable?\n\nA raw `CfnTable` makes you hand-write the `OpenTableFormatInput` JSON\nand own both silent-corruption footguns. `cdk-glue-iceberg-table` gives\nyou a typed `IcebergType` / `IcebergPartitionTransform` API,\nsynth-time validation (partition transforms checked against column\ntypes, format/version mismatches caught before deploy), pinned field\nIDs for safe evolution, and `grantRead` / `grantWrite` helpers. See\n[How it compares](#how-it-compares).\n\n### How do I create a partitioned Iceberg table in CDK?\n\nPass a `partitionSpec` of `IcebergPartitionTransform` entries —\n`identity`, `bucket(N)`, `truncate(W)`, `year`, `month`, `day`, `hour`,\nor `void` — each pinned to a `fieldId` of 1000 or above. Transforms are\nvalidated against their source column's type at synth time. See\n[Using `IcebergTable`](#using-icebergtable).\n\n### Does it work with Athena and Lake Formation?\n\nYes. The demo app in the [`arceus`](https://github.com/ksco92/arceus)\nrepo registers the tables with Lake Formation and queries them from\nAthena, including v2 merge-on-read `INSERT` / `UPDATE` / `DELETE` /\n`MERGE`, time travel, `OPTIMIZE`, and `VACUUM`. The construct's\n`grant*` helpers issue IAM grants; under Lake Formation you still add\nthe matching `SELECT` / `INSERT` LF grants. See [Granting\naccess](#granting-access).\n\n### Can I use Iceberg v2 merge-on-read (row-level UPDATE and DELETE)?\n\nYes — set `formatVersion: IcebergFormatVersion.V2` and the\n`write.{delete,update,merge}.mode = merge-on-read` table properties.\nThe construct rejects merge-on-read on a v1 table at synth time.\n\n## Contributing\n\nDevelopment, the monorepo layout, and the demo app live in [CONTRIBUTING.md](https://github.com/ksco92/arceus/blob/main/CONTRIBUTING.md).\n\n## License\n\n[MIT](https://github.com/ksco92/arceus/blob/main/LICENSE).\n"
9754
+ "markdown": "# cdk-glue-iceberg-table\n\n[![CI](https://img.shields.io/github/actions/workflow/status/ksco92/arceus/ci.yml?branch=main&label=CI)](https://github.com/ksco92/arceus/actions/workflows/ci.yml)\n[![coverage](https://codecov.io/gh/ksco92/arceus/branch/main/graph/badge.svg)](https://codecov.io/gh/ksco92/arceus)\n[![npm](https://img.shields.io/npm/v/cdk-glue-iceberg-table.svg)](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[![PyPI](https://img.shields.io/pypi/v/cdk-glue-iceberg-table.svg)](https://pypi.org/project/cdk-glue-iceberg-table/)\n[![Construct Hub](https://img.shields.io/badge/Construct%20Hub-available-blueviolet)](https://constructs.dev/packages/cdk-glue-iceberg-table)\n[![types](https://img.shields.io/npm/types/cdk-glue-iceberg-table.svg)](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[![downloads](https://img.shields.io/npm/dw/cdk-glue-iceberg-table.svg)](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[![last commit](https://img.shields.io/github/last-commit/ksco92/arceus.svg)](https://github.com/ksco92/arceus/commits/main)\n[![license](https://img.shields.io/npm/l/cdk-glue-iceberg-table.svg)](https://github.com/ksco92/arceus/blob/main/LICENSE)\n\n**`cdk-glue-iceberg-table` is the AWS CDK L2 construct for creating\nand evolving Apache Iceberg tables in the AWS Glue Data Catalog.** It\nemits the exact `AWS::Glue::Table` / `OpenTableFormatInput` shape that\nsurvives a CloudFormation `Update`, so a single `cdk deploy` creates a\ntable, evolves its schema and partitions, and destroys it, the same\nlifecycle CDK gives any other resource. No custom resource, no Lambda,\nno \"`cdk deploy` and then run this SQL by hand\" two-step. Table\nchanges (new columns, renames, drops, new partition fields) land as\na reviewed diff in a pull request and apply through `cdk deploy`.\n\nStatus (October 2026): published on npm (TypeScript/JavaScript) and PyPI\n(Python), pre-1.0, with a public surface guarded by an end-to-end\nconsumer test on every PR plus three real-AWS integration suites. The\nmulti-language packages are generated from one TypeScript source with\n[jsii](https://aws.github.io/jsii/) and indexed on\n[Construct Hub](https://constructs.dev/packages/cdk-glue-iceberg-table).\nDeveloped in the\n[`ksco92/arceus`](https://github.com/ksco92/arceus) monorepo, which\nalso holds a CDK demo app that dogfoods the construct against a real\nAWS account.\n\n### Why this exists\n\nAWS documents the CloudFormation shape for Iceberg tables ([AWS Big\nData blog, December 2025](https://aws.amazon.com/blogs/big-data/create-and-update-apache-iceberg-tables-with-partitions-in-the-aws-glue-data-catalog-using-the-aws-sdk-and-aws-cloudformation)),\nbut raw `AWS::Glue::Table` is a minefield: the CREATE succeeds and the\n*first* `Update` silently strips `table_type=ICEBERG`, after which\nevery Athena query fails with `HIVE_UNSUPPORTED_FORMAT`. The\nmotivating CDK issue is [aws/aws-cdk#29660](https://github.com/aws/aws-cdk/issues/29660);\n[`manmartgarc`'s comment](https://github.com/aws/aws-cdk/issues/29660#issuecomment-4411359248)\ndocuments the only working shape and the silent-corruption traps you\nhit by getting it slightly wrong. This construct implements that\nshape, refuses to emit the unsafe alternatives, and pins Iceberg field\nIDs so schema evolution never orphans existing data. It was the basis\nof an upstream proposal to land an `IcebergTable` in\n`@aws-cdk/aws-glue-alpha` ([aws/aws-cdk#37988](https://github.com/aws/aws-cdk/pull/37988)),\nclosed unmerged in September 2026.\n\n### How it compares\n\n| Approach | Declarative IaC (in the PR) | In-place schema + partition evolution | Prevents the silent-corruption footguns | Typed API + synth-time validation |\n| --- | --- | --- | --- | --- |\n| Raw `CfnTable` (L1) | ✅ | ⚠️ only if you hand-write the exact `OpenTableFormatInput` shape | ❌ you own both footguns | ❌ |\n| CDK custom resource (Lambda + Glue SDK) | ⚠️ via a custom resource you maintain | ⚠️ you write the diff logic | ⚠️ your code's responsibility | ❌ |\n| Spark / Athena SQL DDL at job runtime | ❌ imperative, outside the PR | ✅ but outside CloudFormation | n/a | ❌ |\n| **`cdk-glue-iceberg-table`** | ✅ | ✅ via `cdk deploy` | ✅ both prevented by construction | ✅ |\n\n## Install\n\nTypeScript / JavaScript (npm):\n\n```bash\nnpm install cdk-glue-iceberg-table\n```\n\nPython (PyPI):\n\n```bash\npip install cdk-glue-iceberg-table\n```\n\nPeer dependencies (your CDK app must already have these). This\nrelease requires `aws-cdk-lib` 2.273.0 or newer and `constructs`\n10.8.1 or newer, plus Node.js 22.14 or newer for both languages (the\nPython package runs under Node.js through jsii).\n\nFor TypeScript / JavaScript:\n\n```bash\nnpm install aws-cdk-lib@^2.273.0 constructs@^10.8.1\n```\n\nFor Python:\n\n```bash\npip install 'aws-cdk-lib>=2.273.0' 'constructs>=10.8.1'\n```\n\n## Use\n\n### TypeScript\n\n```ts\nimport { Bucket } from 'aws-cdk-lib/aws-s3';\nimport { Database } from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n IcebergPartitionTransform,\n} from 'cdk-glue-iceberg-table';\n\nconst bucket = new Bucket(this, 'Warehouse');\nconst db = new Database(this, 'Db', { databaseName: 'analytics' });\n\nnew IcebergTable(this, 'OrdersTable', {\n database: db,\n tableName: 'orders',\n location: `s3://${bucket.bucketName}/analytics/orders/`,\n columns: [\n { name: 'order_id', type: IcebergType.LONG, required: true, id: 1 },\n { name: 'customer_id', type: IcebergType.LONG, required: true, id: 2 },\n { name: 'placed_at', type: IcebergType.TIMESTAMPTZ, required: true, id: 3 },\n ],\n partitionSpec: [\n { sourceColumn: 'placed_at', transform: IcebergPartitionTransform.DAY, fieldId: 1000 },\n { sourceColumn: 'customer_id', transform: IcebergPartitionTransform.bucket(16), fieldId: 1001 },\n ],\n identifierFieldNames: ['order_id'],\n formatVersion: IcebergFormatVersion.V2,\n});\n```\n\n### Python\n\nThe same table in Python — the API mirrors TypeScript with\n`snake_case` props and `PascalCase` types:\n\n```python\nfrom aws_cdk.aws_s3 import Bucket\nfrom aws_cdk.aws_glue import Database\nfrom cdk_glue_iceberg_table import (\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n IcebergPartitionTransform,\n)\n\nbucket = Bucket(self, \"Warehouse\")\ndb = Database(self, \"Db\", database_name=\"analytics\")\n\nIcebergTable(self, \"OrdersTable\",\n database=db,\n table_name=\"orders\",\n location=f\"s3://{bucket.bucket_name}/analytics/orders/\",\n columns=[\n {\"name\": \"order_id\", \"type\": IcebergType.LONG, \"required\": True, \"id\": 1},\n {\"name\": \"customer_id\", \"type\": IcebergType.LONG, \"required\": True, \"id\": 2},\n {\"name\": \"placed_at\", \"type\": IcebergType.TIMESTAMPTZ, \"required\": True, \"id\": 3},\n ],\n partition_spec=[\n {\"source_column\": \"placed_at\", \"transform\": IcebergPartitionTransform.DAY, \"field_id\": 1000},\n {\"source_column\": \"customer_id\", \"transform\": IcebergPartitionTransform.bucket(16), \"field_id\": 1001},\n ],\n identifier_field_names=[\"order_id\"],\n format_version=IcebergFormatVersion.V2,\n)\n```\n\nConsumer-facing reference sections:\n\n- [How it compares](#how-it-compares) — `cdk-glue-iceberg-table` vs raw `CfnTable`, custom resources, and runtime SQL DDL.\n- [Using `IcebergTable`](#using-icebergtable) — full API reference with examples.\n- [Two footguns the construct prevents](#two-footguns-the-construct-prevents) — the silent-corruption traps that motivated this construct.\n- [Known limitations](#known-limitations) — what the construct does and doesn't enforce.\n- [FAQ](#faq) — common \"how do I … in CDK / CloudFormation\" questions.\n\n## Exported surface\n\nThe package entry point re-exports everything you import from\n`cdk-glue-iceberg-table`. In TypeScript / JavaScript the compiled\nsurface lives under `dist/lib/iceberg/` after `npm install`; in Python\nthe same surface is imported from the `cdk_glue_iceberg_table` module\nafter `pip install`:\n\n- **`IcebergTable`** — the L2 construct itself, with `grantRead` / `grantWrite` / `grantReadWrite` and the `fromIcebergTableAttributes(...)` import factory.\n- **`IcebergType`** — primitive types plus `list` / `map` / `struct` / `decimal` / `fixed` factories. Renders to the JSON shape Glue's `IcebergStructField.type` expects.\n- **`IcebergPartitionTransform`** — identity / `bucket(N)` / `truncate(W)` / year / month / day / hour / void. Each transform validates against the source column type at synth time.\n- **`IcebergDataFormat`** (parquet/orc/avro, default parquet), **`IcebergFormatVersion`** (v1/v2/v3, required — set explicitly per table; Athena cannot query v3 tables), **`IcebergSortDirection`**, **`IcebergNullOrder`**, plus a `tableProperties` validator that catches misconfigured properties before they leave your machine (wrong codec for the chosen format, `merge-on-read` on a v1 table, non-positive numeric values, …).\n\n## Using `IcebergTable`\n\nA minimal table:\n\n```typescript\nimport {\n Bucket,\n} from 'aws-cdk-lib/aws-s3';\nimport {\n Database,\n} from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n} from 'cdk-glue-iceberg-table';\n\nconst bucket = new Bucket(this, 'Warehouse');\n\nconst db = new Database(this, 'Db', {\n databaseName: 'analytics',\n});\n\nnew IcebergTable(this, 'Users', {\n database: db,\n tableName: 'users',\n columns: [\n {\n name: 'user_id',\n type: IcebergType.LONG,\n required: true,\n id: 1,\n },\n {\n name: 'email',\n type: IcebergType.STRING,\n required: true,\n id: 2,\n },\n {\n name: 'signed_up_at',\n type: IcebergType.TIMESTAMPTZ,\n required: true,\n id: 3,\n },\n ],\n location: `s3://${bucket.bucketName}/analytics/users/`,\n formatVersion: IcebergFormatVersion.V2,\n});\n```\n\nEvery top-level column must declare an `id`: a stable, unique,\npositive integer you pick once and never reuse or reassign. Because\nIceberg data files reference fields by id rather than by name, a fixed\nid is what lets you add, rename, and drop columns across deploys\nwithout corrupting old data — see\n[How do I evolve an Iceberg table schema](#how-do-i-evolve-an-iceberg-table-schema-add-rename-or-drop-a-column-in-cloudformation).\nOnce a column is dropped, leave its id retired; never hand it to a new\ncolumn. (Nested struct/list/map field ids are assigned automatically\nabove the highest top-level id — only top-level column ids are\ncaller-provided.)\n\nA table that exercises most of the surface (partitions, sort order,\nnested types, identifier fields, table properties, removal policy):\n\n```typescript\nimport {\n RemovalPolicy,\n} from 'aws-cdk-lib';\nimport {\n Database,\n} from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergDataFormat,\n IcebergFormatVersion,\n IcebergNullOrder,\n IcebergPartitionTransform,\n IcebergSortDirection,\n IcebergTable,\n IcebergType,\n} from 'cdk-glue-iceberg-table';\n\nnew IcebergTable(this, 'OrdersTable', {\n database: db,\n tableName: 'orders',\n comment: 'Demo Iceberg orders table — exercises partitions, sort order, and merge-on-read.',\n columns: [\n {\n name: 'order_id',\n type: IcebergType.LONG,\n required: true,\n id: 1,\n },\n {\n name: 'customer_id',\n type: IcebergType.LONG,\n required: true,\n id: 2,\n },\n {\n name: 'order_amount',\n type: IcebergType.decimal(12, 2),\n required: true,\n id: 3,\n },\n {\n name: 'currency',\n type: IcebergType.STRING,\n required: true,\n id: 4,\n },\n {\n name: 'placed_at',\n type: IcebergType.TIMESTAMPTZ,\n required: true,\n id: 5,\n },\n {\n name: 'tags',\n type: IcebergType.list(IcebergType.STRING),\n id: 6,\n },\n {\n name: 'shipping_address',\n type: IcebergType.struct([\n {\n name: 'line1',\n type: IcebergType.STRING,\n required: true,\n },\n {\n name: 'city',\n type: IcebergType.STRING,\n required: true,\n },\n {\n name: 'country',\n type: IcebergType.STRING,\n required: true,\n },\n {\n name: 'postal_code',\n type: IcebergType.STRING,\n },\n ]),\n id: 7,\n },\n {\n name: 'metadata',\n type: IcebergType.map(IcebergType.STRING, IcebergType.STRING, false),\n id: 8,\n },\n ],\n location: `s3://${bucket.bucketName}/analytics/orders/`,\n partitionSpec: [\n {\n sourceColumn: 'placed_at',\n transform: IcebergPartitionTransform.DAY,\n fieldId: 1000,\n },\n {\n sourceColumn: 'customer_id',\n transform: IcebergPartitionTransform.bucket(16),\n fieldId: 1001,\n },\n ],\n sortOrder: [\n {\n sourceColumn: 'placed_at',\n direction: IcebergSortDirection.ASC,\n nullOrder: IcebergNullOrder.NULLS_LAST,\n },\n {\n sourceColumn: 'order_id',\n direction: IcebergSortDirection.ASC,\n },\n ],\n identifierFieldNames: [\n 'order_id',\n ],\n dataFormat: IcebergDataFormat.PARQUET,\n formatVersion: IcebergFormatVersion.V2,\n tableProperties: {\n 'write.parquet.compression-codec': 'zstd',\n 'write.delete.mode': 'merge-on-read',\n 'write.update.mode': 'merge-on-read',\n 'write.merge.mode': 'merge-on-read',\n 'write.target-file-size-bytes': '134217728',\n 'history.expire.min-snapshots-to-keep': '5',\n 'gc.enabled': 'true',\n },\n removalPolicy: RemovalPolicy.DESTROY,\n});\n```\n\nEach partition field also pins a `fieldId`: an integer of 1000 or\nabove (the Iceberg spec reserves lower ids for schema columns), unique\nacross the table's entire partition-spec history. The discipline is\nthe inverse of the column-id rule. A column keeps its id forever; a\npartition field keeps its id only while it stays untouched. Change\nanything about a field — swap `month` for `day`, point it at a\ndifferent source column — and it becomes a *new* field that needs a\nfresh, never-before-used id, while the old id retires with the old\nspec. Reusing a retired id (or reassigning an id to a different field)\nproduces a table that Athena still reads but Spark and Trino reject\nwith `ValidationException: Conflicting partition fields`.\n\nThe resulting Iceberg `metadata.json` for this table contains every\nfeature you set:\n\n```json\n{\n \"format-version\": 2,\n \"table-uuid\": \"39a948f9-...\",\n \"current-schema-id\": 0,\n \"schemas\": [\n {\n \"schema-id\": 0,\n \"identifier-field-ids\": [1],\n \"fields\": [\n { \"id\": 1, \"name\": \"order_id\", \"required\": true, \"type\": \"long\" },\n { \"id\": 2, \"name\": \"customer_id\", \"required\": true, \"type\": \"long\" },\n { \"id\": 3, \"name\": \"order_amount\", \"required\": true, \"type\": \"decimal(12, 2)\" },\n { \"id\": 4, \"name\": \"currency\", \"required\": true, \"type\": \"string\" },\n { \"id\": 5, \"name\": \"placed_at\", \"required\": true, \"type\": \"timestamptz\" },\n { \"id\": 6, \"name\": \"tags\", \"required\": false,\n \"type\": { \"type\": \"list\", \"element-id\": 9, \"element\": \"string\", \"element-required\": true } },\n { \"id\": 7, \"name\": \"shipping_address\", \"required\": false,\n \"type\": { \"type\": \"struct\", \"fields\": [\n { \"id\": 10, \"name\": \"line1\", \"required\": true, \"type\": \"string\" },\n { \"id\": 11, \"name\": \"city\", \"required\": true, \"type\": \"string\" },\n { \"id\": 12, \"name\": \"country\", \"required\": true, \"type\": \"string\" },\n { \"id\": 13, \"name\": \"postal_code\", \"required\": false, \"type\": \"string\" }\n ] } },\n { \"id\": 8, \"name\": \"metadata\", \"required\": false,\n \"type\": { \"type\": \"map\", \"key-id\": 14, \"key\": \"string\", \"value-id\": 15,\n \"value-required\": false, \"value\": \"string\" } }\n ]\n }\n ],\n \"partition-specs\": [\n { \"spec-id\": 0, \"fields\": [\n { \"name\": \"placed_at_day\", \"transform\": \"day\", \"source-id\": 5, \"field-id\": 1000 },\n { \"name\": \"customer_id_bucket\", \"transform\": \"bucket[16]\", \"source-id\": 2, \"field-id\": 1001 }\n ]}\n ],\n \"sort-orders\": [\n { \"order-id\": 1, \"fields\": [\n { \"transform\": \"identity\", \"source-id\": 5, \"direction\": \"asc\", \"null-order\": \"nulls-last\" },\n { \"transform\": \"identity\", \"source-id\": 1, \"direction\": \"asc\", \"null-order\": \"nulls-last\" }\n ]}\n ],\n \"properties\": {\n \"format-version\": \"2\",\n \"write.format.default\": \"parquet\",\n \"write.parquet.compression-codec\": \"zstd\",\n \"write.merge.mode\": \"merge-on-read\",\n \"write.update.mode\": \"merge-on-read\",\n \"write.delete.mode\": \"merge-on-read\",\n \"write.target-file-size-bytes\": \"134217728\",\n \"history.expire.min-snapshots-to-keep\": \"5\",\n \"gc.enabled\": \"true\",\n \"comment\": \"Demo Iceberg orders table — exercises partitions, sort order, and merge-on-read.\"\n }\n}\n```\n\n### Granting access\n\n```typescript\ntable.grantRead(role); // Glue read + S3 read on the table's prefix\ntable.grantWrite(role); // Glue write + S3 write\ntable.grantReadWrite(role);\n```\n\nThe `grant*` helpers issue **IAM grants only**. Under Lake Formation\nyou still add the matching `SELECT` / `INSERT` / `DELETE` LF grants on\ntop of the construct's IAM grants for Athena queries to succeed.\n\n### Importing an existing table\n\n```typescript\nconst existing = IcebergTable.fromIcebergTableAttributes(this, 'Orders', {\n database: db,\n tableName: 'orders',\n location: 's3://my-bucket/analytics/orders/',\n});\nexisting.grantRead(role);\n```\n\n### Evolving schema and partitions\n\nChange the `columns` array (or `partitionSpec`) and run `cdk deploy`\nagain. The construct passes the new schema to Glue's `UpdateTable`,\nwhich writes a new `metadata.json` with a new `schema-id`; existing\ndata files stay readable because each column's `id` is pinned and\nnever reused. Adds, renames (same `id`, new `name`), and drops all\nflow through `cdk deploy` alone — no out-of-band SQL DDL.\n\nPartition evolution flows the same way, with one extra rule on\n`fieldId`: a changed partition field is a new partition field. To move\na table from `month(placed_at)` to `day(placed_at)`, drop the month\nentry and add a day entry under a fresh `fieldId` — never recycle the\nmonth field's id:\n\n```typescript\npartitionSpec: [\n // was: { sourceColumn: 'placed_at', transform: IcebergPartitionTransform.MONTH, fieldId: 1000 },\n {\n sourceColumn: 'placed_at',\n transform: IcebergPartitionTransform.DAY,\n fieldId: 1001,\n },\n],\n```\n\nOld data files written under the month spec stay readable; new writes\npartition by day. Reusing `1000` for the day field instead corrupts\nthe spec history for strict engines (Spark, Trino) while Athena keeps\nworking — the failure only surfaces at Spark runtime.\n\n### Inserting and querying\n\n```sql\n-- INSERT into the orders table\nINSERT INTO sample_database.orders VALUES\n (1001, 5001, DECIMAL '149.99', 'USD',\n TIMESTAMP '2026-05-20 09:15:00 UTC',\n ARRAY['holiday-promo','first-order'],\n CAST(ROW('1 Infinite Loop','Cupertino','US','95014')\n AS ROW(line1 VARCHAR,city VARCHAR,country VARCHAR,postal_code VARCHAR)),\n MAP(ARRAY['channel','utm'], ARRAY['web','google'])),\n -- ... more rows\n;\n\n-- merge-on-read DELETE (only legal because we chose v2 + merge-on-read mode)\nDELETE FROM sample_database.orders WHERE order_id = 1003;\n\n-- merge-on-read UPDATE\nUPDATE sample_database.orders SET currency = 'GBP' WHERE customer_id = 5002;\n\n-- SELECT\nSELECT customer_id, SUM(order_amount) AS total\n FROM sample_database.orders\n GROUP BY 1\n ORDER BY 2 DESC;\n```\n\n## Two footguns the construct prevents\n\n### Footgun #1 — schema under `storageDescriptor.columns`\n\nThe CREATE succeeds but the first UPDATE silently strips\n`table_type=ICEBERG` from the table's Glue parameters, and Athena\nqueries after that fail with `HIVE_UNSUPPORTED_FORMAT`.\n\n```typescript\n// DON'T DO THIS — what most StackOverflow / re:Post examples show\nnew CfnTable(this, 'OrdersBad', {\n catalogId: this.account,\n databaseName: 'analytics',\n tableInput: {\n name: 'orders',\n tableType: 'EXTERNAL_TABLE',\n parameters: {\n table_type: 'ICEBERG',\n },\n storageDescriptor: {\n location: 's3://.../orders/',\n columns: [\n /* ... */\n ],\n },\n },\n openTableFormatInput: {\n icebergInput: {\n metadataOperation: 'CREATE',\n version: '2',\n },\n },\n});\n```\n\n`IcebergTable` instead always emits schema/partitions/sort/properties\nunder `openTableFormatInput.icebergInput.icebergTableInput`, never\nunder `storageDescriptor`.\n\n### Footgun #2 — `tableInput` co-present with `openTableFormatInput`\n\nEven setting just `tableInput: { name: 'foo' }` next to\n`openTableFormatInput` returns\n`\"Table metadata is expected only via TableInput or via IcebergTableInputProperties inside OpenTableFormatInput\"`.\nThe construct never emits `tableInput`; the table-level comment goes\ninto `tableProperties['comment']`, which lives inside\n`icebergTableInput.properties`.\n\n(There is a third footgun, field-id reuse after a column drop, that\nthe construct does **not** prevent. See the next section.)\n\n## Known limitations\n\n- **Field-id reuse is not detected across deploys.** If you drop a column with `id = 5` and then add a different column with `id = 5` in a later deploy, Glue accepts the UPDATE and Iceberg's metadata silently violates the \"never reuse a retired id\" invariant. Readers projecting old snapshots will surface deleted data under the new field's name. The construct enforces uniqueness **within one deploy** (`duplicate column id N` validator), but it doesn't compare against the live table state. The safe workflow is to always pin `id` explicitly and treat dropped ids as retired forever; never let CDK reassign an id that has ever been used.\n- **Partition field-id reuse is not detected across deploys either.** The same live-state blindness applies to partition `fieldId`s: the construct validates them within one deploy (integer >= 1000, unique in the spec), but it cannot tell that the id you pinned already appeared in an earlier spec of the deployed table. The invariant partition ids must uphold is stricter than the column one — unique across the table's **entire spec history**, so a changed field (different transform or source column) must take a fresh id rather than keep its old one. Violate it and strict engines (Spark, Trino) reject the table with `Conflicting partition fields` while Athena keeps answering, masking the break until Spark runtime. The safe workflow: treat every id that has ever appeared in any spec as retired, and allocate new fields the next never-used id.\n- **`last-partition-id` is written by Glue, not by the construct.** The construct supplies the spec's field ids; Glue's `UpdateTable` computes the table's `last-partition-id` counter when it writes the new metadata. The repo's integration test asserts the counter keeps up with the highest supplied field id after a partition evolution, but engines that later evolve the spec themselves (e.g. Spark `ALTER TABLE … ADD PARTITION FIELD`) allocate from that counter — if you mix CDK-managed and engine-managed partition evolution, verify the counter in `metadata.json` before trusting engine-side changes.\n- **CREATE-only metadata operation.** The CFN `IcebergInput.metadataOperation` only accepts `CREATE`; the construct always emits that. Subsequent deploys use Glue's normal `UpdateTable` path, which writes new Iceberg metadata in-place.\n- **Format version is immutable after CREATE.** The `formatVersion` prop is read once at table creation; changing it later requires a destroy + recreate.\n- **`merge-on-read` requires v2 or later.** The construct rejects `write.{delete,update,merge}.mode = merge-on-read` on a v1 table at synth time.\n- **Athena DDL features that don't surface through CFN** (e.g. `ALTER TABLE WRITE ORDERED BY`, `ALTER TABLE … SET LOCATION`, `bucketed_by` / `bucket_count` Hive clauses) are not exposed. Use `IcebergPartitionTransform.bucket(N)` instead of Hive bucketing.\n- **Dropping a partition column requires a `void` intermediate per the Iceberg spec**, and the CFN `OpenTableFormatInput` cannot express that. The construct accepts the change, but Athena queries against the result will fail with `Type cannot be null`. The safe pattern is to drop partitions that source from a column while keeping that column in the schema, and only drop a column once it is no longer partitioning anything.\n\n## FAQ\n\n### How do I create an Apache Iceberg table in AWS CDK?\n\nInstall `cdk-glue-iceberg-table`, then declare an `IcebergTable` with a\ndatabase, a column list, and an S3 `location` — see [Use](#use).\n`cdk deploy` creates the Glue Data Catalog table and writes the\nIceberg `metadata.json` under your S3 prefix. No custom resource or\nLambda is involved; it is a plain `AWS::Glue::Table` in your\nCloudFormation template.\n\n### How do I evolve an Iceberg table schema (add, rename, or drop a column) in CloudFormation?\n\nChange the `columns` array and run `cdk deploy` again. The construct\npasses the new schema to Glue's `UpdateTable`, which writes a new\n`metadata.json` with a new `schema-id`; existing data files stay\nreadable because each column's `id` is pinned and never reused.\nPartition changes work the same way, except a changed partition field\ntakes a fresh `fieldId` instead of keeping its old one. See [Evolving\nschema and partitions](#evolving-schema-and-partitions).\n\n### Does CloudFormation support Iceberg tables natively?\n\nYes, through `AWS::Glue::Table` with `OpenTableFormatInput.IcebergInput`,\ndocumented by AWS in [December 2025](https://aws.amazon.com/blogs/big-data/create-and-update-apache-iceberg-tables-with-partitions-in-the-aws-glue-data-catalog-using-the-aws-sdk-and-aws-cloudformation).\nThe catch is that the raw shape corrupts the table on the first\n`Update` if you place schema under `storageDescriptor.columns` or set\n`tableInput` alongside `openTableFormatInput`. This construct only ever\nemits the safe shape and gives you no way to express the unsafe ones.\nSee [Two footguns the construct prevents](#two-footguns-the-construct-prevents).\n\n### What is the difference between cdk-glue-iceberg-table and a raw CfnTable?\n\nA raw `CfnTable` makes you hand-write the `OpenTableFormatInput` JSON\nand own both silent-corruption footguns. `cdk-glue-iceberg-table` gives\nyou a typed `IcebergType` / `IcebergPartitionTransform` API,\nsynth-time validation (partition transforms checked against column\ntypes, format/version mismatches caught before deploy), pinned field\nIDs for safe evolution, and `grantRead` / `grantWrite` helpers. See\n[How it compares](#how-it-compares).\n\n### How do I create a partitioned Iceberg table in CDK?\n\nPass a `partitionSpec` of `IcebergPartitionTransform` entries —\n`identity`, `bucket(N)`, `truncate(W)`, `year`, `month`, `day`, `hour`,\nor `void` — each pinned to a `fieldId` of 1000 or above. Transforms are\nvalidated against their source column's type at synth time. See\n[Using `IcebergTable`](#using-icebergtable).\n\n### Does it work with Athena and Lake Formation?\n\nYes. The demo app in the [`arceus`](https://github.com/ksco92/arceus)\nrepo registers the tables with Lake Formation and queries them from\nAthena, including v2 merge-on-read `INSERT` / `UPDATE` / `DELETE` /\n`MERGE`, time travel, `OPTIMIZE`, and `VACUUM`. The construct's\n`grant*` helpers issue IAM grants; under Lake Formation you still add\nthe matching `SELECT` / `INSERT` LF grants. See [Granting\naccess](#granting-access).\n\n### Can I use Iceberg v2 merge-on-read (row-level UPDATE and DELETE)?\n\nYes — set `formatVersion: IcebergFormatVersion.V2` and the\n`write.{delete,update,merge}.mode = merge-on-read` table properties.\nThe construct rejects merge-on-read on a v1 table at synth time.\n\n## Contributing\n\nDevelopment, the monorepo layout, and the demo app live in [CONTRIBUTING.md](https://github.com/ksco92/arceus/blob/main/CONTRIBUTING.md).\n\n## License\n\n[MIT](https://github.com/ksco92/arceus/blob/main/LICENSE).\n"
9755
9755
  },
9756
9756
  "repository": {
9757
9757
  "directory": "packages/cdk-glue-iceberg-table",
@@ -10039,7 +10039,7 @@
10039
10039
  "kind": "enum",
10040
10040
  "locationInModule": {
10041
10041
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10042
- "line": 23
10042
+ "line": 26
10043
10043
  },
10044
10044
  "members": [
10045
10045
  {
@@ -10094,6 +10094,13 @@
10094
10094
  "summary": "v2 — adds row-level deletes."
10095
10095
  },
10096
10096
  "name": "V2"
10097
+ },
10098
+ {
10099
+ "docs": {
10100
+ "stability": "experimental",
10101
+ "summary": "v3 — adds deletion vectors and row lineage."
10102
+ },
10103
+ "name": "V3"
10097
10104
  }
10098
10105
  ],
10099
10106
  "name": "IcebergFormatVersion",
@@ -10626,7 +10633,7 @@
10626
10633
  "kind": "class",
10627
10634
  "locationInModule": {
10628
10635
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10629
- "line": 35
10636
+ "line": 38
10630
10637
  },
10631
10638
  "name": "IcebergPropertyKeys",
10632
10639
  "properties": [
@@ -10639,7 +10646,7 @@
10639
10646
  "immutable": true,
10640
10647
  "locationInModule": {
10641
10648
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10642
- "line": 76
10649
+ "line": 79
10643
10650
  },
10644
10651
  "name": "COMMIT_RETRY_NUM_RETRIES",
10645
10652
  "static": true,
@@ -10656,7 +10663,7 @@
10656
10663
  "immutable": true,
10657
10664
  "locationInModule": {
10658
10665
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10659
- "line": 37
10666
+ "line": 40
10660
10667
  },
10661
10668
  "name": "FORMAT_VERSION",
10662
10669
  "static": true,
@@ -10673,7 +10680,7 @@
10673
10680
  "immutable": true,
10674
10681
  "locationInModule": {
10675
10682
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10676
- "line": 67
10683
+ "line": 70
10677
10684
  },
10678
10685
  "name": "GC_ENABLED",
10679
10686
  "static": true,
@@ -10690,7 +10697,7 @@
10690
10697
  "immutable": true,
10691
10698
  "locationInModule": {
10692
10699
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10693
- "line": 70
10700
+ "line": 73
10694
10701
  },
10695
10702
  "name": "HISTORY_EXPIRE_MAX_SNAPSHOT_AGE_MS",
10696
10703
  "static": true,
@@ -10707,7 +10714,7 @@
10707
10714
  "immutable": true,
10708
10715
  "locationInModule": {
10709
10716
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10710
- "line": 73
10717
+ "line": 76
10711
10718
  },
10712
10719
  "name": "HISTORY_EXPIRE_MIN_SNAPSHOTS_TO_KEEP",
10713
10720
  "static": true,
@@ -10724,7 +10731,7 @@
10724
10731
  "immutable": true,
10725
10732
  "locationInModule": {
10726
10733
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10727
- "line": 49
10734
+ "line": 52
10728
10735
  },
10729
10736
  "name": "WRITE_AVRO_COMPRESSION_CODEC",
10730
10737
  "static": true,
@@ -10741,7 +10748,7 @@
10741
10748
  "immutable": true,
10742
10749
  "locationInModule": {
10743
10750
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10744
- "line": 55
10751
+ "line": 58
10745
10752
  },
10746
10753
  "name": "WRITE_DELETE_MODE",
10747
10754
  "static": true,
@@ -10758,7 +10765,7 @@
10758
10765
  "immutable": true,
10759
10766
  "locationInModule": {
10760
10767
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10761
- "line": 64
10768
+ "line": 67
10762
10769
  },
10763
10770
  "name": "WRITE_DISTRIBUTION_MODE",
10764
10771
  "static": true,
@@ -10775,7 +10782,7 @@
10775
10782
  "immutable": true,
10776
10783
  "locationInModule": {
10777
10784
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10778
- "line": 40
10785
+ "line": 43
10779
10786
  },
10780
10787
  "name": "WRITE_FORMAT_DEFAULT",
10781
10788
  "static": true,
@@ -10792,7 +10799,7 @@
10792
10799
  "immutable": true,
10793
10800
  "locationInModule": {
10794
10801
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10795
- "line": 61
10802
+ "line": 64
10796
10803
  },
10797
10804
  "name": "WRITE_MERGE_MODE",
10798
10805
  "static": true,
@@ -10809,7 +10816,7 @@
10809
10816
  "immutable": true,
10810
10817
  "locationInModule": {
10811
10818
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10812
- "line": 46
10819
+ "line": 49
10813
10820
  },
10814
10821
  "name": "WRITE_ORC_COMPRESSION_CODEC",
10815
10822
  "static": true,
@@ -10826,7 +10833,7 @@
10826
10833
  "immutable": true,
10827
10834
  "locationInModule": {
10828
10835
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10829
- "line": 43
10836
+ "line": 46
10830
10837
  },
10831
10838
  "name": "WRITE_PARQUET_COMPRESSION_CODEC",
10832
10839
  "static": true,
@@ -10843,7 +10850,7 @@
10843
10850
  "immutable": true,
10844
10851
  "locationInModule": {
10845
10852
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10846
- "line": 52
10853
+ "line": 55
10847
10854
  },
10848
10855
  "name": "WRITE_TARGET_FILE_SIZE_BYTES",
10849
10856
  "static": true,
@@ -10860,7 +10867,7 @@
10860
10867
  "immutable": true,
10861
10868
  "locationInModule": {
10862
10869
  "filename": "lib/iceberg/iceberg-table-properties.ts",
10863
- "line": 58
10870
+ "line": 61
10864
10871
  },
10865
10872
  "name": "WRITE_UPDATE_MODE",
10866
10873
  "static": true,
@@ -12635,6 +12642,6 @@
12635
12642
  "symbolId": "lib/iceberg/iceberg-type:IcebergTypeOptions"
12636
12643
  }
12637
12644
  },
12638
- "version": "0.7.4",
12639
- "fingerprint": "ipfRTU4eJw1GDXmLCb2H/wfnCACMF45Nl2x4vStfCrs="
12645
+ "version": "0.8.0",
12646
+ "fingerprint": "yGdNS7tdFvVkHaVqMJLfzjjoOZDE5s1K/Ep2F0mkOIw="
12640
12647
  }
package/README.md CHANGED
@@ -178,7 +178,7 @@ after `pip install`:
178
178
  - **`IcebergTable`** — the L2 construct itself, with `grantRead` / `grantWrite` / `grantReadWrite` and the `fromIcebergTableAttributes(...)` import factory.
179
179
  - **`IcebergType`** — primitive types plus `list` / `map` / `struct` / `decimal` / `fixed` factories. Renders to the JSON shape Glue's `IcebergStructField.type` expects.
180
180
  - **`IcebergPartitionTransform`** — identity / `bucket(N)` / `truncate(W)` / year / month / day / hour / void. Each transform validates against the source column type at synth time.
181
- - **`IcebergDataFormat`** (parquet/orc/avro, default parquet), **`IcebergFormatVersion`** (v1/v2, required — set explicitly per table), **`IcebergSortDirection`**, **`IcebergNullOrder`**, plus a `tableProperties` validator that catches misconfigured properties before they leave your machine (wrong codec for the chosen format, `merge-on-read` on a v1 table, non-positive numeric values, …).
181
+ - **`IcebergDataFormat`** (parquet/orc/avro, default parquet), **`IcebergFormatVersion`** (v1/v2/v3, required — set explicitly per table; Athena cannot query v3 tables), **`IcebergSortDirection`**, **`IcebergNullOrder`**, plus a `tableProperties` validator that catches misconfigured properties before they leave your machine (wrong codec for the chosen format, `merge-on-read` on a v1 table, non-positive numeric values, …).
182
182
 
183
183
  ## Using `IcebergTable`
184
184
 
@@ -586,7 +586,7 @@ the construct does **not** prevent. See the next section.)
586
586
  - **`last-partition-id` is written by Glue, not by the construct.** The construct supplies the spec's field ids; Glue's `UpdateTable` computes the table's `last-partition-id` counter when it writes the new metadata. The repo's integration test asserts the counter keeps up with the highest supplied field id after a partition evolution, but engines that later evolve the spec themselves (e.g. Spark `ALTER TABLE … ADD PARTITION FIELD`) allocate from that counter — if you mix CDK-managed and engine-managed partition evolution, verify the counter in `metadata.json` before trusting engine-side changes.
587
587
  - **CREATE-only metadata operation.** The CFN `IcebergInput.metadataOperation` only accepts `CREATE`; the construct always emits that. Subsequent deploys use Glue's normal `UpdateTable` path, which writes new Iceberg metadata in-place.
588
588
  - **Format version is immutable after CREATE.** The `formatVersion` prop is read once at table creation; changing it later requires a destroy + recreate.
589
- - **`merge-on-read` requires v2.** The construct rejects `write.{delete,update,merge}.mode = merge-on-read` on a v1 table at synth time.
589
+ - **`merge-on-read` requires v2 or later.** The construct rejects `write.{delete,update,merge}.mode = merge-on-read` on a v1 table at synth time.
590
590
  - **Athena DDL features that don't surface through CFN** (e.g. `ALTER TABLE WRITE ORDERED BY`, `ALTER TABLE … SET LOCATION`, `bucketed_by` / `bucket_count` Hive clauses) are not exposed. Use `IcebergPartitionTransform.bucket(N)` instead of Hive bucketing.
591
591
  - **Dropping a partition column requires a `void` intermediate per the Iceberg spec**, and the CFN `OpenTableFormatInput` cannot express that. The construct accepts the change, but Athena queries against the result will fail with `Type cannot be null`. The safe pattern is to drop partitions that source from a column while keeping that column in the schema, and only drop a column once it is no longer partitioning anything.
592
592
 
@@ -26,7 +26,7 @@ var IcebergPartitionTransformKind;
26
26
  * it is legal to apply against.
27
27
  */
28
28
  class IcebergPartitionTransform {
29
- static [JSII_RTTI_SYMBOL_1] = { fqn: "cdk-glue-iceberg-table.IcebergPartitionTransform", version: "0.7.4" };
29
+ static [JSII_RTTI_SYMBOL_1] = { fqn: "cdk-glue-iceberg-table.IcebergPartitionTransform", version: "0.8.0" };
30
30
  /** `identity` — source value unmodified. Legal on any column type. */
31
31
  static IDENTITY = new IcebergPartitionTransform({
32
32
  kind: IcebergPartitionTransformKind.IDENTITY,
@@ -14,7 +14,9 @@ export declare enum IcebergFormatVersion {
14
14
  /** v1 — read-only Hive-compatible analytic tables. */
15
15
  V1 = "1",
16
16
  /** v2 — adds row-level deletes. */
17
- V2 = "2"
17
+ V2 = "2",
18
+ /** v3 — adds deletion vectors and row lineage. */
19
+ V3 = "3"
18
20
  }
19
21
  /** Data-file storage format for an Iceberg table. */
20
22
  export declare enum IcebergDataFormat {
@@ -21,6 +21,8 @@ var IcebergFormatVersion;
21
21
  IcebergFormatVersion["V1"] = "1";
22
22
  /** v2 — adds row-level deletes. */
23
23
  IcebergFormatVersion["V2"] = "2";
24
+ /** v3 — adds deletion vectors and row lineage. */
25
+ IcebergFormatVersion["V3"] = "3";
24
26
  })(IcebergFormatVersion || (exports.IcebergFormatVersion = IcebergFormatVersion = {}));
25
27
  /** Data-file storage format for an Iceberg table. */
26
28
  var IcebergDataFormat;
@@ -34,7 +36,7 @@ var IcebergDataFormat;
34
36
  })(IcebergDataFormat || (exports.IcebergDataFormat = IcebergDataFormat = {}));
35
37
  /** Canonical Iceberg property keys the L2 understands. */
36
38
  class IcebergPropertyKeys {
37
- static [JSII_RTTI_SYMBOL_1] = { fqn: "cdk-glue-iceberg-table.IcebergPropertyKeys", version: "0.7.4" };
39
+ static [JSII_RTTI_SYMBOL_1] = { fqn: "cdk-glue-iceberg-table.IcebergPropertyKeys", version: "0.8.0" };
38
40
  /** `format-version`. */
39
41
  static FORMAT_VERSION = 'format-version';
40
42
  /** `write.format.default`. */
@@ -128,7 +130,7 @@ function validateIcebergProperties(dataFormat, formatVersion, properties) {
128
130
  validateEnumProperty(properties, IcebergPropertyKeys.WRITE_UPDATE_MODE, WRITE_MODES);
129
131
  validateEnumProperty(properties, IcebergPropertyKeys.WRITE_MERGE_MODE, WRITE_MODES);
130
132
  validateEnumProperty(properties, IcebergPropertyKeys.WRITE_DISTRIBUTION_MODE, DISTRIBUTION_MODES);
131
- /// 5. merge-on-read requires format-version=2.
133
+ /// 5. merge-on-read requires format-version 2 or later.
132
134
  if (formatVersion === IcebergFormatVersion.V1) {
133
135
  for (const key of [
134
136
  IcebergPropertyKeys.WRITE_DELETE_MODE,
@@ -136,7 +138,7 @@ function validateIcebergProperties(dataFormat, formatVersion, properties) {
136
138
  IcebergPropertyKeys.WRITE_MERGE_MODE,
137
139
  ]) {
138
140
  if (properties[key] === 'merge-on-read') {
139
- throw new Error(`tableProperties['${key}'] = 'merge-on-read' requires formatVersion v2; got v1`);
141
+ throw new Error(`tableProperties['${key}'] = 'merge-on-read' requires formatVersion v2 or later; got v1`);
140
142
  }
141
143
  }
142
144
  }
@@ -197,4 +199,4 @@ function validatePositiveInt(properties, key) {
197
199
  throw new Error(`tableProperties['${key}'] = '${raw}' must be a positive integer string.`);
198
200
  }
199
201
  }
200
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaWNlYmVyZy10YWJsZS1wcm9wZXJ0aWVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vbGliL2ljZWJlcmcvaWNlYmVyZy10YWJsZS1wcm9wZXJ0aWVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQThIQSw4REF3REM7O0FBdExEOzs7Ozs7Ozs7O0dBVUc7QUFFSCx1RUFBdUU7QUFDdkUsSUFBWSxvQkFNWDtBQU5ELFdBQVksb0JBQW9CO0lBQzVCLHNEQUFzRDtJQUN0RCxnQ0FBUSxDQUFBO0lBRVIsbUNBQW1DO0lBQ25DLGdDQUFRLENBQUE7QUFDWixDQUFDLEVBTlcsb0JBQW9CLG9DQUFwQixvQkFBb0IsUUFNL0I7QUFFRCxxREFBcUQ7QUFDckQsSUFBWSxpQkFTWDtBQVRELFdBQVksaUJBQWlCO0lBQ3pCLGdDQUFnQztJQUNoQyx3Q0FBbUIsQ0FBQTtJQUVuQixrQkFBa0I7SUFDbEIsZ0NBQVcsQ0FBQTtJQUVYLG1CQUFtQjtJQUNuQixrQ0FBYSxDQUFBO0FBQ2pCLENBQUMsRUFUVyxpQkFBaUIsaUNBQWpCLGlCQUFpQixRQVM1QjtBQUVELDBEQUEwRDtBQUMxRCxNQUFhLG1CQUFtQjs7SUFDNUIsd0JBQXdCO0lBQ2pCLE1BQU0sQ0FBVSxjQUFjLEdBQUcsZ0JBQWdCLENBQUM7SUFFekQsOEJBQThCO0lBQ3ZCLE1BQU0sQ0FBVSxvQkFBb0IsR0FBRyxzQkFBc0IsQ0FBQztJQUVyRSx5Q0FBeUM7SUFDbEMsTUFBTSxDQUFVLCtCQUErQixHQUFHLGlDQUFpQyxDQUFDO0lBRTNGLHFDQUFxQztJQUM5QixNQUFNLENBQVUsMkJBQTJCLEdBQUcsNkJBQTZCLENBQUM7SUFFbkYsc0NBQXNDO0lBQy9CLE1BQU0sQ0FBVSw0QkFBNEIsR0FBRyw4QkFBOEIsQ0FBQztJQUVyRixzQ0FBc0M7SUFDL0IsTUFBTSxDQUFVLDRCQUE0QixHQUFHLDhCQUE4QixDQUFDO0lBRXJGLDJCQUEyQjtJQUNwQixNQUFNLENBQVUsaUJBQWlCLEdB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LEdBQUcsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQzdDLE1BQU0sSUFBSSxLQUFLLENBQ1gsb0JBQW9CLEdBQUcsU0FBUyxLQUFLLGtCQUFrQjtjQUNyRCxZQUFZLEtBQUssQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUMsSUFBSSxFQUFFLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQ3pELENBQUM7SUFDTixDQUFDO0FBQ0wsQ0FBQztBQUVELFNBQVMsbUJBQW1CLENBQ3hCLFVBQXFDLEVBQ3JDLEdBQVc7SUFFWCxNQUFNLEdBQUcsR0FBRyxVQUFVLENBQUMsR0FBRyxDQUFDLENBQUM7SUFDNUIsSUFBSSxHQUFHLEtBQUssU0FBUyxFQUFFLENBQUM7UUFDcEIsT0FBTztJQUNYLENBQUM7SUFDRCxJQUFJLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsSUFBSSxNQUFNLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDM0MsTUFBTSxJQUFJLEtBQUssQ0FDWCxvQkFBb0IsR0FBRyxTQUFTLEdBQUcsc0NBQXNDLENBQzVFLENBQUM7SUFDTixDQUFDO0FBQ0wsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogSWNlYmVyZyB0YWJsZSBwcm9wZXJ0eSBrZXlzIGFuZCB2YWxpZGF0aW9uLlxuICpcbiAqIGBBV1M6OkdsdWU6OlRhYmxlLk9wZW5UYWJsZUZvcm1hdElucHV0LkljZWJlcmdJbnB1dC5JY2ViZXJnVGFibGVJbnB1dC5wcm9wZXJ0aWVzYFxuICogaXMgYSBmcmVlLWZvcm0gc3RyaW5nIG1hcC4gR2x1ZSBkb2VzIG5vdCB2YWxpZGF0ZSB0aGUga2V5cywgYnV0XG4gKiBBdGhlbmEncyB3cml0ZXIgd2lsbCByZWplY3QgcXVlcmllcyBhZ2FpbnN0IHRhYmxlcyB3aG9zZSBwcm9wZXJ0aWVzXG4gKiBjb250cmFkaWN0IGVhY2ggb3RoZXIgKGUuZy4gYHdyaXRlLmZvcm1hdC5kZWZhdWx0PXBhcnF1ZXRgIHdpdGhcbiAqIGB3cml0ZS5wYXJxdWV0LmNvbXByZXNzaW9uLWNvZGVjPWx6b2ApLiBUaGUgTDIgZW5mb3JjZXMgdGhlIHNhbWVcbiAqIG1hdHJpeCBhdCBzeW50aCB0aW1lIHNvIHRoYXQgbWlzY29uZmlndXJlZCB0YWJsZXMgbmV2ZXIgbWFrZSBpdCB0b1xuICogYSBkZXBsb3kuXG4gKi9cblxuLyoqIEFwYWNoZSBJY2ViZXJnIGZvcm1hdCB2ZXJzaW9uLiBSZXF1aXJlZCBvbiBldmVyeSBgSWNlYmVyZ1RhYmxlYC4gKi9cbmV4cG9ydCBlbnVtIEljZWJlcmdGb3JtYXRWZXJzaW9uIHtcbiAgICAvKiogdjEg4oCUIHJlYWQtb25seSBIaXZlLWNvbXBhdGlibGUgYW5hbHl0aWMgdGFibGVzLiAqL1xuICAgIFYxID0gJzEnLFxuXG4gICAgLyoqIHYyIOKAlCBhZGRzIHJvdy1sZXZlbCBkZWxldGVzLiAqL1xuICAgIFYyID0gJzInLFxufVxuXG4vKiogRGF0YS1maWxlIHN0b3JhZ2UgZm9ybWF0IGZvciBhbiBJY2ViZXJnIHRhYmxlLiAqL1xuZXhwb3J0IGVudW0gSWNlYmVyZ0RhdGFGb3JtYXQge1xuICAgIC8qKiBBcGFjaGUgUGFycXVldCAoZGVmYXVsdCkuICovXG4gICAgUEFSUVVFVCA9ICdwYXJxdWV0JyxcblxuICAgIC8qKiBBcGFjaGUgT1JDLiAqL1xuICAgIE9SQyA9ICdvcmMnLFxuXG4gICAgLyoqIEFwYWNoZSBBdnJvLiAqL1xuICAgIEFWUk8gPSAnYXZybycsXG59XG5cbi8qKiBDYW5vbmljYWwgSWNlYmVyZyBwcm9wZXJ0eSBrZXlzIHRoZSBMMiB1bmRlcnN0YW5kcy4gKi9cbmV4cG9ydCBjbGFzcyBJY2ViZXJnUHJvcGVydHlLZXlzIHtcbiAgICAvKiogYGZvcm1hdC12ZXJzaW9uYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IEZPUk1BVF9WRVJTSU9OID0gJ2Zvcm1hdC12ZXJzaW9uJztcblxuICAgIC8qKiBgd3JpdGUuZm9ybWF0LmRlZmF1bHRgLiAqL1xuICAgIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgV1JJVEVfRk9STUFUX0RFRkFVTFQgPSAnd3JpdGUuZm9ybWF0LmRlZmF1bHQnO1xuXG4gICAgLyoqIGB3cml0ZS5wYXJxdWV0LmNvbXByZXNzaW9uLWNvZGVjYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IFdSSVRFX1BBUlFVRVRfQ09NUFJFU1NJT05fQ09ERUMgPSAnd3JpdGUucGFycXVldC5jb21wcmVzc2lvbi1jb2RlYyc7XG5cbiAgICAvKiogYHdyaXRlLm9yYy5jb21wcmVzc2lvbi1jb2RlY2AuICovXG4gICAgcHVibGljIHN0YXRpYyByZWFkb25seSBXUklURV9PUkNfQ09NUFJFU1NJT05fQ09ERUMgPSAnd3JpdGUub3JjLmNvbXByZXNzaW9uLWNvZGVjJztcblxuICAgIC8qKiBgd3JpdGUuYXZyby5jb21wcmVzc2lvbi1jb2RlY2AuICovXG4gICAgcHVibGljIHN0YXRpYyByZWFkb25seSBXUklURV9BVlJPX0NPTVBSRVNTSU9OX0NPREVDID0gJ3dyaXRlLmF2cm8uY29tcHJlc3Npb24tY29kZWMnO1xuXG4gICAgLyoqIGB3cml0ZS50YXJnZXQtZmlsZS1zaXplLWJ5dGVzYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IFdSSVRFX1RBUkdFVF9GSUxFX1NJWkVfQllURVMgPSAnd3JpdGUudGFyZ2V0LWZpbGUtc2l6ZS1ieXRlcyc7XG5cbiAgICAvKiogYHdyaXRlLmRlbGV0ZS5tb2RlYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IFdSSVRFX0RFTEVURV9NT0RFID0gJ3dyaXRlLmRlbGV0ZS5tb2RlJztcblxuICAgIC8qKiBgd3JpdGUudXBkYXRlLm1vZGVgLiAqL1xuICAgIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgV1JJVEVfVVBEQVRFX01PREUgPSAnd3JpdGUudXBkYXRlLm1vZGUnO1xuXG4gICAgLyoqIGB3cml0ZS5tZXJnZS5tb2RlYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IFdSSVRFX01FUkdFX01PREUgPSAnd3JpdGUubWVyZ2UubW9kZSc7XG5cbiAgICAvKiogYHdyaXRlLmRpc3RyaWJ1dGlvbi1tb2RlYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IFdSSVRFX0RJU1RSSUJVVElPTl9NT0RFID0gJ3dyaXRlLmRpc3RyaWJ1dGlvbi1tb2RlJztcblxuICAgIC8qKiBgZ2MuZW5hYmxlZGAuICovXG4gICAgcHVibGljIHN0YXRpYyByZWFkb25seSBHQ19FTkFCTEVEID0gJ2djLmVuYWJsZWQnO1xuXG4gICAgLyoqIGBoaXN0b3J5LmV4cGlyZS5tYXgtc25hcHNob3QtYWdlLW1zYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IEhJU1RPUllfRVhQSVJFX01BWF9TTkFQU0hPVF9BR0VfTVMgPSAnaGlzdG9yeS5leHBpcmUubWF4LXNuYXBzaG90LWFnZS1tcyc7XG5cbiAgICAvKiogYGhpc3RvcnkuZXhwaXJlLm1pbi1zbmFwc2hvdHMtdG8ta2VlcGAuICovXG4gICAgcHVibGljIHN0YXRpYyByZWFkb25seSBISVNUT1JZX0VYUElSRV9NSU5fU05BUFNIT1RTX1RPX0tFRVAgPSAnaGlzdG9yeS5leHBpcmUubWluLXNuYXBzaG90cy10by1rZWVwJztcblxuICAgIC8qKiBgY29tbWl0LnJldHJ5Lm51bS1yZXRyaWVzYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IENPTU1JVF9SRVRSWV9OVU1fUkVUUklFUyA9ICdjb21taXQucmV0cnkubnVtLXJldHJpZXMnO1xufVxuXG5jb25zdCBQQVJRVUVUX0NPREVDUyA9IG5ldyBTZXQoW1xuICAgICd6c3RkJyxcbiAgICAnc25hcHB5JyxcbiAgICAnZ3ppcCcsXG4gICAgJ2Jyb3RsaScsXG4gICAgJ2x6NCcsXG4gICAgJ3VuY29tcHJlc3NlZCcsXG5dKTtcblxuY29uc3QgT1JDX0NPREVDUyA9IG5ldyBTZXQoW1xuICAgICd6c3RkJyxcbiAgICAnc25hcHB5JyxcbiAgICAnemxpYicsXG4gICAgJ2x6NCcsXG4gICAgJ2x6bycsXG4gICAgJ25vbmUnLFxuXSk7XG5cbmNvbnN0IEFWUk9fQ09ERUNTID0gbmV3IFNldChbXG4gICAgJ2d6aXAnLFxuICAgICdzbmFwcHknLFxuICAgICd6c3RkJyxcbiAgICAndW5jb21wcmVzc2VkJyxcbl0pO1xuXG5jb25zdCBXUklURV9NT0RFUyA9IG5ldyBTZXQoW1xuICAgICdjb3B5LW9uLXdyaXRlJyxcbiAgICAnbWVyZ2Utb24tcmVhZCcsXG5dKTtcblxuY29uc3QgRElTVFJJQlVUSU9OX01PREVTID0gbmV3IFNldChbXG4gICAgJ25vbmUnLFxuICAgICdoYXNoJyxcbiAgICAncmFuZ2UnLFxuXSk7XG5cbmNvbnN0IEJPT0xFQU5fVkFMVUVTID0gbmV3IFNldChbXG4gICAgJ3RydWUnLFxuICAgICdmYWxzZScsXG5dKTtcblxuLyoqXG4gKiBWYWxpZGF0ZXMgdGhhdCB0aGUgbWVyZ2VkIHByb3BlcnR5IG1hcCBmb3IgYSB0YWJsZSBpcyBpbnRlcm5hbGx5XG4gKiBjb25zaXN0ZW50LiBUaHJvd3MgYEVycm9yYCBvbiB0aGUgZmlyc3QgY29uZmxpY3Qgc28gdGhlIHVzZXIgc2Vlc1xuICogb25lIGNsZWFyIG1lc3NhZ2UgcGVyIGRlcGxveS5cbiAqXG4gKiBAaW50ZXJuYWxcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHZhbGlkYXRlSWNlYmVyZ1Byb3BlcnRpZXMoXG4gICAgZGF0YUZvcm1hdDogSWNlYmVyZ0RhdGFGb3JtYXQsXG4gICAgZm9ybWF0VmVyc2lvbjogSWNlYmVyZ0Zvcm1hdFZlcnNpb24sXG4gICAgcHJvcGVydGllczogeyBba2V5OiBzdHJpbmddOiBzdHJpbmcgfSxcbik6IHZvaWQge1xuICAgIC8vLyAxLiB3cml0ZS5mb3JtYXQuZGVmYXVsdCBtdXN0IG1hdGNoIHRoZSBjaG9zZW4gZGF0YSBmb3JtYXQuXG4gICAgY29uc3QgZGVjbGFyZWRGb3JtYXQgPSBwcm9wZXJ0aWVzW0ljZWJlcmdQcm9wZXJ0eUtleXMuV1JJVEVfRk9STUFUX0RFRkFVTFRdO1xuICAgIGlmIChkZWNsYXJlZEZvcm1hdCAhPT0gdW5kZWZpbmVkICYmIGRlY2xhcmVkRm9ybWF0ICE9PSBkYXRhRm9ybWF0KSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgICAgIGB0YWJsZVByb3BlcnRpZXNbJyR7SWNlYmVyZ1Byb3BlcnR5S2V5cy5XUklURV9GT1JNQVRfREVGQVVMVH0nXSBpcyAnJHtkZWNsYXJlZEZvcm1hdH0nIGBcbiAgICAgICAgICAgICsgYGJ1dCBkYXRhRm9ybWF0IGlzICcke2RhdGFGb3JtYXR9Jy4gRHJvcCB0aGUgcHJvcGVydHkgb3IgY2hhbmdlIGRhdGFGb3JtYXQgdG8gbWF0Y2guYCxcbiAgICAgICAgKTtcbiAgICB9XG5cbiAgICAvLy8gMi4gZm9ybWF0LXZlcnNpb24gbXVzdCBtYXRjaCB0aGUgY2hvc2VuIGZvcm1hdCB2ZXJzaW9uLlxuICAgIGNvbnN0IGRlY2xhcmVkVmVyc2lvbiA9IHByb3BlcnRpZXNbSWNlYmVyZ1Byb3BlcnR5S2V5cy5GT1JNQVRfVkVSU0lPTl07XG4gICAgaWYgKGRlY2xhcmVkVmVyc2lvbiAhPT0gdW5kZWZpbmVkICYmIGRlY2xhcmVkVmVyc2lvbiAhPT0gZm9ybWF0VmVyc2lvbikge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgICAgICBgdGFibGVQcm9wZXJ0aWVzWycke0ljZWJlcmdQcm9wZXJ0eUtleXMuRk9STUFUX1ZFUlNJT059J10gaXMgJyR7ZGVjbGFyZWRWZXJzaW9ufScgYFxuICAgICAgICAgICAgKyBgYnV0IGZvcm1hdFZlcnNpb24gaXMgJyR7Zm9ybWF0VmVyc2lvbn0nLiBEcm9wIHRoZSBwcm9wZXJ0eSBvciBjaGFuZ2UgZm9ybWF0VmVyc2lvbiB0byBtYXRjaC5gLFxuICAgICAgICApO1xuICAgIH1cblxuICAgIC8vLyAzLiBDb21wcmVzc2lvbiBjb2RlYyBtdXN0IGJlIHZhbGlkIGZvciB0aGUgY2hvc2VuIGZvcm1hdCBhbmRcbiAgICAvLy8gICAgbXVzdCBiZSBzZXQgb24gdGhlIGNvcnJlY3QgY29kZWMga2V5IGZvciB0aGF0IGZvcm1hdC5cbiAgICB2YWxpZGF0ZUNvbXByZXNzaW9uRm9yRm9ybWF0KGRhdGFGb3JtYXQsIHByb3BlcnRpZXMpO1xuXG4gICAgLy8vIDQuIHdyaXRlIG1vZGVzIG11c3QgYmUgdmFsaWQgSWNlYmVyZyBsaXRlcmFscy5cbiAgICB2YWxpZGF0ZUVudW1Qcm9wZXJ0eShwcm9wZXJ0aWVzLCBJY2ViZXJnUHJvcGVydHlLZXlzLldSSVRFX0RFTEVURV9NT0RFLCBXUklURV9NT0RFUyk7XG4gICAgdmFsaWRhdGVFbnVtUHJvcGVydHkocHJvcGVydGllcywgSWNlYmVyZ1Byb3BlcnR5S2V5cy5XUklURV9VUERBVEVfTU9ERSwgV1JJVEVfTU9ERVMpO1xuICAgIHZhbGlkYXRlRW51bVByb3BlcnR5KHByb3BlcnRpZXMsIEljZWJlcmdQcm9wZXJ0eUtleXMuV1JJVEVfTUVSR0VfTU9ERSwgV1JJVEVfTU9ERVMpO1xuICAgIHZhbGlkYXRlRW51bVByb3BlcnR5KHByb3BlcnRpZXMsIEljZWJlcmdQcm9wZXJ0eUtleXMuV1JJVEVfRElTVFJJQlVUSU9OX01PREUsIERJU1RSSUJVVElPTl9NT0RFUyk7XG5cbiAgICAvLy8gNS4gbWVyZ2Utb24tcmVhZCByZXF1aXJlcyBmb3JtYXQtdmVyc2lvbj0yLlxuICAgIGlmIChmb3JtYXRWZXJzaW9uID09PSBJY2ViZXJnRm9ybWF0VmVyc2lvbi5WMSkge1xuICAgICAgICBmb3IgKGNvbnN0IGtleSBvZiBbXG4gICAgICAgICAgICBJY2ViZXJnUHJvcGVydHlLZXlzLldSSVRFX0RFTEVURV9NT0RFLFxuICAgICAgICAgICAgSWNlYmVyZ1Byb3BlcnR5S2V5cy5XUklURV9VUERBVEVfTU9ERSxcbiAgICAgICAgICAgIEljZWJlcmdQcm9wZXJ0eUtleXMuV1JJVEVfTUVSR0VfTU9ERSxcbiAgICAgICAgXSkge1xuICAgICAgICAgICAgaWYgKHByb3BlcnRpZXNba2V5XSA9PT0gJ21lcmdlLW9uLXJlYWQnKSB7XG4gICAgICAgICAgICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICAgICAgICAgICAgICBgdGFibGVQcm9wZXJ0aWVzWycke2tleX0nXSA9ICdtZXJnZS1vbi1yZWFkJyByZXF1aXJlcyBmb3JtYXRWZXJzaW9uIHYyOyBnb3QgdjFgLFxuICAgICAgICAgICAgICAgICk7XG4gICAgICAgICAgICB9XG4gICAgICAgIH1cbiAgICB9XG5cbiAgICAvLy8gNi4gZ2MuZW5hYmxlZCBpcyBhIGJvb2xlYW4uXG4gICAgdmFsaWRhdGVFbnVtUHJvcGVydHkocHJvcGVydGllcywgSWNlYmVyZ1Byb3BlcnR5S2V5cy5HQ19FTkFCTEVELCBCT09MRUFOX1ZBTFVFUyk7XG5cbiAgICAvLy8gNy4gTnVtZXJpYyBwcm9wZXJ0aWVzIG11c3QgcGFyc2UgdG8gcG9zaXRpdmUgaW50ZWdlcnMuXG4gICAgdmFsaWRhdGVQb3NpdGl2ZUludChwcm9wZXJ0aWVzLCBJY2ViZXJnUHJvcGVydHlLZXlzLldSSVRFX1RBUkdFVF9GSUxFX1NJWkVfQllURVMpO1xuICAgIHZhbGlkYXRlUG9zaXRpdmVJbnQocHJvcGVydGllcywgSWNlYmVyZ1Byb3BlcnR5S2V5cy5ISVNUT1JZX0VYUElSRV9NQVhfU05BUFNIT1RfQUdFX01TKTtcbiAgICB2YWxpZGF0ZVBvc2l0aXZlSW50KHByb3BlcnRpZXMsIEljZWJlcmdQcm9wZXJ0eUtleXMuSElTVE9SWV9FWFBJUkVfTUlOX1NOQVBTSE9UU19UT19LRUVQKTtcbiAgICB2YWxpZGF0ZVBvc2l0aXZlSW50KHByb3BlcnRpZXMsIEljZWJlcmdQcm9wZXJ0eUtleXMuQ09NTUlUX1JFVFJZX05VTV9SRVRSSUVTKTtcbn1cblxuZnVuY3Rpb24gdmFsaWRhdGVDb21wcmVzc2lvbkZvckZvcm1hdChcbiAgICBkYXRhRm9ybWF0OiBJY2ViZXJnRGF0YUZvcm1hdCxcbiAgICBwcm9wZXJ0aWVzOiB7IFtrZXk6IHN0cmluZ106IHN0cmluZyB9LFxuKTogdm9pZCB7XG4gICAgY29uc3QgY2FuZGlkYXRlczogQXJyYXk8eyBrZXk6IHN0cmluZzsgYWxsb3dlZDogUmVhZG9ubHlTZXQ8c3RyaW5nPjsgb3duZXJGb3JtYXQ6IEljZWJlcmdEYXRhRm9ybWF0IH0+ID0gW1xuICAgICAgICB7XG4gICAgICAgICAgICBrZXk6IEljZWJlcmdQcm9wZXJ0eUtleXMuV1JJVEVfUEFSUVVFVF9DT01QUkVTU0lPTl9DT0RFQyxcbiAgICAgICAgICAgIGFsbG93ZWQ6IFBBUlFVRVRfQ09ERUNTLFxuICAgICAgICAgICAgb3duZXJGb3JtYXQ6IEljZWJlcmdEYXRhRm9ybWF0LlBBUlFVRVQsXG4gICAgICAgIH0sXG4gICAgICAgIHtcbiAgICAgICAgICAgIGtleTogSWNlYmVyZ1Byb3BlcnR5S2V5cy5XUklURV9PUkNfQ09NUFJFU1NJT05fQ09ERUMsXG4gICAgICAgICAgICBhbGxvd2VkOiBPUkNfQ09ERUNTLFxuICAgICAgICAgICAgb3duZXJGb3JtYXQ6IEljZWJlcmdEYXRhRm9ybWF0Lk9SQyxcbiAgICAgICAgfSxcbiAgICAgICAge1xuICAgICAgICAgICAga2V5OiBJY2ViZXJnUHJvcGVydHlLZXlzLldSSVRFX0FWUk9fQ09NUFJFU1NJT05fQ09ERUMsXG4gICAgICAgICAgICBhbGxvd2VkOiBBVlJPX0NPREVDUyxcbiAgICAgICAgICAgIG93bmVyRm9ybWF0OiBJY2ViZXJnRGF0YUZvcm1hdC5BVlJPLFxuICAgICAgICB9LFxuICAgIF07XG4gICAgZm9yIChjb25zdCBjYW5kaWRhdGUgb2YgY2FuZGlkYXRlcykge1xuICAgICAgICBjb25zdCB2YWx1ZSA9IHByb3BlcnRpZXNbY2FuZGlkYXRlLmtleV07XG4gICAgICAgIGlmICh2YWx1ZSA9PT0gdW5kZWZpbmVkKSB7XG4gICAgICAgICAgICBjb250aW51ZTtcbiAgICAgICAgfVxuICAgICAgICBpZiAoY2FuZGlkYXRlLm93bmVyRm9ybWF0ICE9PSBkYXRhRm9ybWF0KSB7XG4gICAgICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgICAgICAgICAgYHRhYmxlUHJvcGVydGllc1snJHtjYW5kaWRhdGUua2V5fSddIGlzIHNldCBidXQgZGF0YUZvcm1hdCBpcyAnJHtkYXRhRm9ybWF0fScuIGBcbiAgICAgICAgICAgICAgICArIGBUaGF0IGNvZGVjIGtleSBvbmx5IGFwcGxpZXMgdG8gJyR7Y2FuZGlkYXRlLm93bmVyRm9ybWF0fScgdGFibGVzLmAsXG4gICAgICAgICAgICApO1xuICAgICAgICB9XG4gICAgICAgIGlmICghY2FuZGlkYXRlLmFsbG93ZWQuaGFzKHZhbHVlKSkge1xuICAgICAgICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICAgICAgICAgIGB0YWJsZVByb3BlcnRpZXNbJyR7Y2FuZGlkYXRlLmtleX0nXSA9ICcke3ZhbHVlfScgaXMgbm90IGEgdmFsaWQgJHtjYW5kaWRhdGUub3duZXJGb3JtYXR9IGBcbiAgICAgICAgICAgICAgICArIGBjb21wcmVzc2lvbiBjb2RlYy4gQWxsb3dlZDogJHtBcnJheS5mcm9tKGNhbmRpZGF0ZS5hbGxvd2VkKS5zb3J0KCkuam9pbignLCAnKX0uYCxcbiAgICAgICAgICAgICk7XG4gICAgICAgIH1cbiAgICB9XG59XG5cbmZ1bmN0aW9uIHZhbGlkYXRlRW51bVByb3BlcnR5KFxuICAgIHByb3BlcnRpZXM6IHsgW2tleTogc3RyaW5nXTogc3RyaW5nIH0sXG4gICAga2V5OiBzdHJpbmcsXG4gICAgYWxsb3dlZDogUmVhZG9ubHlTZXQ8c3RyaW5nPixcbik6IHZvaWQge1xuICAgIGNvbnN0IHZhbHVlID0gcHJvcGVydGllc1trZXldO1xuICAgIGlmICh2YWx1ZSAhPT0gdW5kZWZpbmVkICYmICFhbGxvd2VkLmhhcyh2YWx1ZSkpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICAgICAgYHRhYmxlUHJvcGVydGllc1snJHtrZXl9J10gPSAnJHt2YWx1ZX0nIGlzIG5vdCB2YWxpZC4gYFxuICAgICAgICAgICAgKyBgQWxsb3dlZDogJHtBcnJheS5mcm9tKGFsbG93ZWQpLnNvcnQoKS5qb2luKCcsICcpfS5gLFxuICAgICAgICApO1xuICAgIH1cbn1cblxuZnVuY3Rpb24gdmFsaWRhdGVQb3NpdGl2ZUludChcbiAgICBwcm9wZXJ0aWVzOiB7IFtrZXk6IHN0cmluZ106IHN0cmluZyB9LFxuICAgIGtleTogc3RyaW5nLFxuKTogdm9pZCB7XG4gICAgY29uc3QgcmF3ID0gcHJvcGVydGllc1trZXldO1xuICAgIGlmIChyYXcgPT09IHVuZGVmaW5lZCkge1xuICAgICAgICByZXR1cm47XG4gICAgfVxuICAgIGlmICghL15bMC05XSskLy50ZXN0KHJhdykgfHwgTnVtYmVyKHJhdykgPCAxKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgICAgIGB0YWJsZVByb3BlcnRpZXNbJyR7a2V5fSddID0gJyR7cmF3fScgbXVzdCBiZSBhIHBvc2l0aXZlIGludGVnZXIgc3RyaW5nLmAsXG4gICAgICAgICk7XG4gICAgfVxufVxuIl19
202
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaWNlYmVyZy10YWJsZS1wcm9wZXJ0aWVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vbGliL2ljZWJlcmcvaWNlYmVyZy10YWJsZS1wcm9wZXJ0aWVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQWlJQSw4REF3REM7O0FBekxEOzs7Ozs7Ozs7O0dBVUc7QUFFSCx1RUFBdUU7QUFDdkUsSUFBWSxvQkFTWDtBQVRELFdBQVksb0JBQW9CO0lBQzVCLHNEQUFzRDtJQUN0RCxnQ0FBUSxDQUFBO0lBRVIsbUNBQW1DO0lBQ25DLGdDQUFRLENBQUE7SUFFUixrREFBa0Q7SUFDbEQsZ0NBQVEsQ0FBQTtBQUNaLENBQUMsRUFUVyxvQkFBb0Isb0NBQXBCLG9CQUFvQixRQVMvQjtBQUVELHFEQUFxRDtBQUNyRCxJQUFZLGlCQVNYO0FBVEQsV0FBWSxpQkFBaUI7SUFDekIsZ0NBQWdDO0lBQ2hDLHdDQUFtQixDQUFBO0lBRW5CLGtCQUFrQjtJQUNsQixnQ0FBVyxDQUFBO0lBRVgsbUJBQW1CO0lBQ25CLGtDQUFhLENBQUE7QUFDakIsQ0FBQyxFQVRXLGlCQUFpQixpQ0FBakIsaUJBQWlCLFFBUzVCO0FBRUQsMERBQTBEO0FBQzFELE1BQWEsbUJBQW1COztJQUM1Qix3QkFBd0I7SUFDakIsTUFBTSxDQUFVLGNBQWMsR0FBRyxnQkFBZ0IsQ0FBQztJQUV6RCw4QkFBOEI7SUFDdkIsTUFBTSxDQUFVLG9CQUFvQixHQUFHLHNCQUFzQixDQUFDO0lBRXJFLHlDQUF5QztJQUNsQyxNQUFNLENBQVUsK0JBQStCLEdBQUcsaUNBQWlDLENBQUM7SUFFM0YscUNBQXFDO0lBQzlCLE1BQU0sQ0FBVSwyQkFBMkIsR0FBRyw2QkFBNkIsQ0FBQztJQUVuRixzQ0FBc0M7SUFDL0IsTUFBTSxDQUFVLDRCQUE0QixHQUFHLDhCQUE4QixDQUFDO0lBRXJGLHNDQUFzQztJQUMvQixNQUFNLENBQVUsNEJBQTRCLEdBQUcsOEJBQThCLENBQUM7SUFFckYsMkJBQTJCO0lBQ3BCLE1BQU0sQ0FBVSxpQkFBaUIsR0FBRyxtQkFBbUIsQ0FBQztJQUUvRCwyQkFBMkI7SUFDcEIsTUFBTSxDQUFVLGlCQUFpQixHQUFHLG1CQUFtQixDQUFDO0lBRS9ELDBCQUEwQjtJQUNuQixNQUFNLENBQVUsZ0JBQWdCLEdBQUcsa0JBQWtCLENBQUM7SUFFN0QsaUNBQWlDO0lBQzFCLE1BQU0sQ0FBVSx1QkFBdUIsR0FBRyx5QkFBeUIsQ0FBQztJQUUzRSxvQkFBb0I7SUFDYixNQUFNLENBQVUsVUFBVSxHQUFHLFlBQVksQ0FBQztJQUVqRCw0Q0FBNEM7SUFDckMsTUFBTSxDQUFVLGtDQUFrQyxHQUFHLG9DQUFvQyxDQUFDO0lBRWpHLDhDQUE4QztJQUN2QyxNQUFNLENBQVUsb0NBQW9DLEdBQUcsc0NBQXNDLENBQUM7SUFFckcsa0NBQWtDO0lBQzNCLE1BQU0sQ0FBVSx3QkFBd0IsR0FBRywwQkFBMEIsQ0FBQzs7QUF6Q2pGLGtEQTBDQztBQUVELE1BQU0sY0FBYyxHQUFHLElBQUksR0FBRyxDQUFDO0lBQzNCLE1BQU07SUFDTixRQUFRO0lBQ1IsTUFBTTtJQUNOLFFBQVE7SUFDUixLQUFLO0lBQ0wsY0FBYztDQUNqQixDQUFDLENBQUM7QUFFSCxNQUFNLFVBQVUsR0FBRyxJQUFJLEdBQUcsQ0FBQztJQUN2QixNQUFNO0lBQ04sUUFBUTtJQUNSLE1BQU07SUFDTixLQUFLO0lBQ0wsS0FBSztJQUNMLE1BQU07Q0FDVCxDQUFDLENBQUM7QUFFSCxNQUFNLFdBQVcsR0FBRyxJQUFJLEdBQUcsQ0FBQztJQUN4QixNQUFNO0lBQ04sUUFBUTtJQUNSLE1BQU07SUFDTixjQUFjO0NBQ2pCLENBQUMsQ0FBQztBQUVILE1BQU0sV0FBVyxHQUFHLElBQUksR0FBRyxDQUFDO0lBQ3hCLGVBQWU7SUFDZixlQUFlO0NBQ2xCLENBQUMsQ0FBQztBQUVILE1BQU0sa0JBQWtCLEdBQUcsSUFBSSxHQUFHLENBQUM7SUFDL0IsTUFBTTtJQUNOLE1BQU07SUFDTixPQUFPO0NBQ1YsQ0FBQyxDQUFDO0FBRUgsTUFBTSxjQUFjLEdBQUcsSUFBSSxHQUFHLENBQUM7SUFDM0IsTUFBTTtJQUNOLE9BQU87Q0FDVixDQUFDLENBQUM7QUFFSDs7Ozs7O0dBTUc7QUFDSCxTQUFnQix5QkFBeUIsQ0FDckMsVUFBNkIsRUFDN0IsYUFBbUMsRUFDbkMsVUFBcUM7SUFFckMsOERBQThEO0lBQzlELE1BQU0sY0FBYyxHQUFHLFVBQVUsQ0FBQyxtQkFBbUIsQ0FBQyxvQkFBb0IsQ0FBQyxDQUFDO0lBQzVFLElBQUksY0FBYyxLQUFLLFNBQVMsSUFBSSxjQUFjLEtBQUssVUFBVSxFQUFFLENBQUM7UUFDaEUsTUFBTSxJQUFJLEtBQUssQ0FDWCxvQkFBb0IsbUJBQW1CLENBQUMsb0JBQW9CLFVBQVUsY0FBYyxJQUFJO2NBQ3RGLHNCQUFzQixVQUFVLHFEQUFxRCxDQUMxRixDQUFDO0lBQ04sQ0FBQztJQUVELDJEQUEyRDtJQUMzRCxNQUFNLGVBQWUsR0FBRyxVQUFVLENBQUMsbUJBQW1CLENBQUMsY0FBYyxDQUFDLENBQUM7SUFDdkUsSUFBSSxlQUFlLEtBQUssU0FBUyxJQUFJLGVBQWUsS0FBSyxhQUFhLEVBQUUsQ0FBQztRQUNyRSxNQUFNLElBQUksS0FBSyxDQUNYLG9CQUFvQixtQkFBbUIsQ0FBQyxjQUFjLFVBQVUsZUFBZSxJQUFJO2NBQ2pGLHlCQUF5QixhQUFhLHdEQUF3RCxDQUNuRyxDQUFDO0lBQ04sQ0FBQztJQUVELGdFQUFnRTtJQUNoRSw0REFBNEQ7SUFDNUQsNEJBQTRCLENBQUMsVUFBVSxFQUFFLFVBQVUsQ0FBQyxDQUFDO0lBRXJELGtEQUFrRDtJQUNsRCxvQkFBb0IsQ0FBQyxVQUFVLEVBQUUsbUJBQW1CLENBQUMsaUJBQWlCLEVBQUUsV0FBVyxDQUFDLENBQUM7SUFDckYsb0JBQW9CLENBQUMsVUFBVSxFQUFFLG1CQUFtQixDQUFDLGlCQUFpQixFQUFFLFdBQVcsQ0FBQyxDQUFDO0lBQ3JGLG9CQUFvQixDQUFDLFVBQVUsRUFBRSxtQkFBbUIsQ0FBQyxnQkFBZ0IsRUFBRSxXQUFXLENBQUMsQ0FBQztJQUNwRixvQkFBb0IsQ0FBQyxVQUFVLEVBQUUsbUJBQW1CLENBQUMsdUJBQXVCLEVBQUUsa0JBQWtCLENBQUMsQ0FBQztJQUVsRyx3REFBd0Q7SUFDeEQsSUFBSSxhQUFhLEtBQUssb0JBQW9CLENBQUMsRUFBRSxFQUFFLENBQUM7UUFDNUMsS0FBSyxNQUFNLEdBQUcsSUFBSTtZQUNkLG1CQUFtQixDQUFDLGlCQUFpQjtZQUNyQyxtQkFBbUIsQ0FBQyxpQkFBaUI7WUFDckMsbUJBQW1CLENBQUMsZ0JBQWdCO1NBQ3ZDLEVBQUUsQ0FBQztZQUNBLElBQUksVUFBVSxDQUFDLEdBQUcsQ0FBQyxLQUFLLGVBQWUsRUFBRSxDQUFDO2dCQUN0QyxNQUFNLElBQUksS0FBSyxDQUNYLG9CQUFvQixHQUFHLGlFQUFpRSxDQUMzRixDQUFDO1lBQ04sQ0FBQztRQUNMLENBQUM7SUFDTCxDQUFDO0lBRUQsK0JBQStCO0lBQy9CLG9CQUFvQixDQUFDLFVBQVUsRUFBRSxtQkFBbUIsQ0FBQyxVQUFVLEVBQUUsY0FBYyxDQUFDLENBQUM7SUFFakYsMERBQTBEO0lBQzFELG1CQUFtQixDQUFDLFVBQVUsRUFBRSxtQkFBbUIsQ0FBQyw0QkFBNEIsQ0FBQyxDQUFDO0lBQ2xGLG1CQUFtQixDQUFDLFVBQVUsRUFBRSxtQkFBbUIsQ0FBQyxrQ0FBa0MsQ0FBQyxDQUFDO0lBQ3hGLG1CQUFtQixDQUFDLFVBQVUsRUFBRSxtQkFBbUIsQ0FBQyxvQ0FBb0MsQ0FBQyxDQUFDO0lBQzFGLG1CQUFtQixDQUFDLFVBQVUsRUFBRSxtQkFBbUIsQ0FBQyx3QkFBd0IsQ0FBQyxDQUFDO0FBQ2xGLENBQUM7QUFFRCxTQUFTLDRCQUE0QixDQUNqQyxVQUE2QixFQUM3QixVQUFxQztJQUVyQyxNQUFNLFVBQVUsR0FBeUY7UUFDckc7WUFDSSxHQUFHLEVBQUUsbUJBQW1CLENBQUMsK0JBQStCO1lBQ3hELE9BQU8sRUFBRSxjQUFjO1lBQ3ZCLFdBQVcsRUFBRSxpQkFBaUIsQ0FBQyxPQUFPO1NBQ3pDO1FBQ0Q7WUFDSSxHQUFHLEVBQUUsbUJBQW1CLENBQUMsMkJBQTJCO1lBQ3BELE9BQU8sRUFBRSxVQUFVO1lBQ25CLFdBQVcsRUFBRSxpQkFBaUIsQ0FBQyxHQUFHO1NBQ3JDO1FBQ0Q7WUFDSSxHQUFHLEVBQUUsbUJBQW1CLENBQUMsNEJBQTRCO1lBQ3JELE9BQU8sRUFBRSxXQUFXO1lBQ3BCLFdBQVcsRUFBRSxpQkFBaUIsQ0FBQyxJQUFJO1NBQ3RDO0tBQ0osQ0FBQztJQUNGLEtBQUssTUFBTSxTQUFTLElBQUksVUFBVSxFQUFFLENBQUM7UUFDakMsTUFBTSxLQUFLLEdBQUcsVUFBVSxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUN4QyxJQUFJLEtBQUssS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUN0QixTQUFTO1FBQ2IsQ0FBQztRQUNELElBQUksU0FBUyxDQUFDLFdBQVcsS0FBSyxVQUFVLEVBQUUsQ0FBQztZQUN2QyxNQUFNLElBQUksS0FBSyxDQUNYLG9CQUFvQixTQUFTLENBQUMsR0FBRyxnQ0FBZ0MsVUFBVSxLQUFLO2tCQUM5RSxtQ0FBbUMsU0FBUyxDQUFDLFdBQVcsV0FBVyxDQUN4RSxDQUFDO1FBQ04sQ0FBQztRQUNELElBQUksQ0FBQyxTQUFTLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1lBQ2hDLE1BQU0sSUFBSSxLQUFLLENBQ1gsb0JBQW9CLFNBQVMsQ0FBQyxHQUFHLFNBQVMsS0FBSyxvQkFBb0IsU0FBUyxDQUFDLFdBQVcsR0FBRztrQkFDekYsK0JBQStCLEtBQUssQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUN0RixDQUFDO1FBQ04sQ0FBQztJQUNMLENBQUM7QUFDTCxDQUFDO0FBRUQsU0FBUyxvQkFBb0IsQ0FDekIsVUFBcUMsRUFDckMsR0FBVyxFQUNYLE9BQTRCO0lBRTVCLE1BQU0sS0FBSyxHQUFHLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUM5QixJQUFJLEtBQUssS0FBSyxTQUFTLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDN0MsTUFBTSxJQUFJLEtBQUssQ0FDWCxvQkFBb0IsR0FBRyxTQUFTLEtBQUssa0JBQWtCO2NBQ3JELFlBQVksS0FBSyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FDekQsQ0FBQztJQUNOLENBQUM7QUFDTCxDQUFDO0FBRUQsU0FBUyxtQkFBbUIsQ0FDeEIsVUFBcUMsRUFDckMsR0FBVztJQUVYLE1BQU0sR0FBRyxHQUFHLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUM1QixJQUFJLEdBQUcsS0FBSyxTQUFTLEVBQUUsQ0FBQztRQUNwQixPQUFPO0lBQ1gsQ0FBQztJQUNELElBQUksQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQztRQUMzQyxNQUFNLElBQUksS0FBSyxDQUNYLG9CQUFvQixHQUFHLFNBQVMsR0FBRyxzQ0FBc0MsQ0FDNUUsQ0FBQztJQUNOLENBQUM7QUFDTCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBJY2ViZXJnIHRhYmxlIHByb3BlcnR5IGtleXMgYW5kIHZhbGlkYXRpb24uXG4gKlxuICogYEFXUzo6R2x1ZTo6VGFibGUuT3BlblRhYmxlRm9ybWF0SW5wdXQuSWNlYmVyZ0lucHV0LkljZWJlcmdUYWJsZUlucHV0LnByb3BlcnRpZXNgXG4gKiBpcyBhIGZyZWUtZm9ybSBzdHJpbmcgbWFwLiBHbHVlIGRvZXMgbm90IHZhbGlkYXRlIHRoZSBrZXlzLCBidXRcbiAqIEF0aGVuYSdzIHdyaXRlciB3aWxsIHJlamVjdCBxdWVyaWVzIGFnYWluc3QgdGFibGVzIHdob3NlIHByb3BlcnRpZXNcbiAqIGNvbnRyYWRpY3QgZWFjaCBvdGhlciAoZS5nLiBgd3JpdGUuZm9ybWF0LmRlZmF1bHQ9cGFycXVldGAgd2l0aFxuICogYHdyaXRlLnBhcnF1ZXQuY29tcHJlc3Npb24tY29kZWM9bHpvYCkuIFRoZSBMMiBlbmZvcmNlcyB0aGUgc2FtZVxuICogbWF0cml4IGF0IHN5bnRoIHRpbWUgc28gdGhhdCBtaXNjb25maWd1cmVkIHRhYmxlcyBuZXZlciBtYWtlIGl0IHRvXG4gKiBhIGRlcGxveS5cbiAqL1xuXG4vKiogQXBhY2hlIEljZWJlcmcgZm9ybWF0IHZlcnNpb24uIFJlcXVpcmVkIG9uIGV2ZXJ5IGBJY2ViZXJnVGFibGVgLiAqL1xuZXhwb3J0IGVudW0gSWNlYmVyZ0Zvcm1hdFZlcnNpb24ge1xuICAgIC8qKiB2MSDigJQgcmVhZC1vbmx5IEhpdmUtY29tcGF0aWJsZSBhbmFseXRpYyB0YWJsZXMuICovXG4gICAgVjEgPSAnMScsXG5cbiAgICAvKiogdjIg4oCUIGFkZHMgcm93LWxldmVsIGRlbGV0ZXMuICovXG4gICAgVjIgPSAnMicsXG5cbiAgICAvKiogdjMg4oCUIGFkZHMgZGVsZXRpb24gdmVjdG9ycyBhbmQgcm93IGxpbmVhZ2UuICovXG4gICAgVjMgPSAnMycsXG59XG5cbi8qKiBEYXRhLWZpbGUgc3RvcmFnZSBmb3JtYXQgZm9yIGFuIEljZWJlcmcgdGFibGUuICovXG5leHBvcnQgZW51bSBJY2ViZXJnRGF0YUZvcm1hdCB7XG4gICAgLyoqIEFwYWNoZSBQYXJxdWV0IChkZWZhdWx0KS4gKi9cbiAgICBQQVJRVUVUID0gJ3BhcnF1ZXQnLFxuXG4gICAgLyoqIEFwYWNoZSBPUkMuICovXG4gICAgT1JDID0gJ29yYycsXG5cbiAgICAvKiogQXBhY2hlIEF2cm8uICovXG4gICAgQVZSTyA9ICdhdnJvJyxcbn1cblxuLyoqIENhbm9uaWNhbCBJY2ViZXJnIHByb3BlcnR5IGtleXMgdGhlIEwyIHVuZGVyc3RhbmRzLiAqL1xuZXhwb3J0IGNsYXNzIEljZWJlcmdQcm9wZXJ0eUtleXMge1xuICAgIC8qKiBgZm9ybWF0LXZlcnNpb25gLiAqL1xuICAgIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgRk9STUFUX1ZFUlNJT04gPSAnZm9ybWF0LXZlcnNpb24nO1xuXG4gICAgLyoqIGB3cml0ZS5mb3JtYXQuZGVmYXVsdGAuICovXG4gICAgcHVibGljIHN0YXRpYyByZWFkb25seSBXUklURV9GT1JNQVRfREVGQVVMVCA9ICd3cml0ZS5mb3JtYXQuZGVmYXVsdCc7XG5cbiAgICAvKiogYHdyaXRlLnBhcnF1ZXQuY29tcHJlc3Npb24tY29kZWNgLiAqL1xuICAgIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgV1JJVEVfUEFSUVVFVF9DT01QUkVTU0lPTl9DT0RFQyA9ICd3cml0ZS5wYXJxdWV0LmNvbXByZXNzaW9uLWNvZGVjJztcblxuICAgIC8qKiBgd3JpdGUub3JjLmNvbXByZXNzaW9uLWNvZGVjYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IFdSSVRFX09SQ19DT01QUkVTU0lPTl9DT0RFQyA9ICd3cml0ZS5vcmMuY29tcHJlc3Npb24tY29kZWMnO1xuXG4gICAgLyoqIGB3cml0ZS5hdnJvLmNvbXByZXNzaW9uLWNvZGVjYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IFdSSVRFX0FWUk9fQ09NUFJFU1NJT05fQ09ERUMgPSAnd3JpdGUuYXZyby5jb21wcmVzc2lvbi1jb2RlYyc7XG5cbiAgICAvKiogYHdyaXRlLnRhcmdldC1maWxlLXNpemUtYnl0ZXNgLiAqL1xuICAgIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgV1JJVEVfVEFSR0VUX0ZJTEVfU0laRV9CWVRFUyA9ICd3cml0ZS50YXJnZXQtZmlsZS1zaXplLWJ5dGVzJztcblxuICAgIC8qKiBgd3JpdGUuZGVsZXRlLm1vZGVgLiAqL1xuICAgIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgV1JJVEVfREVMRVRFX01PREUgPSAnd3JpdGUuZGVsZXRlLm1vZGUnO1xuXG4gICAgLyoqIGB3cml0ZS51cGRhdGUubW9kZWAuICovXG4gICAgcHVibGljIHN0YXRpYyByZWFkb25seSBXUklURV9VUERBVEVfTU9ERSA9ICd3cml0ZS51cGRhdGUubW9kZSc7XG5cbiAgICAvKiogYHdyaXRlLm1lcmdlLm1vZGVgLiAqL1xuICAgIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgV1JJVEVfTUVSR0VfTU9ERSA9ICd3cml0ZS5tZXJnZS5tb2RlJztcblxuICAgIC8qKiBgd3JpdGUuZGlzdHJpYnV0aW9uLW1vZGVgLiAqL1xuICAgIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgV1JJVEVfRElTVFJJQlVUSU9OX01PREUgPSAnd3JpdGUuZGlzdHJpYnV0aW9uLW1vZGUnO1xuXG4gICAgLyoqIGBnYy5lbmFibGVkYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IEdDX0VOQUJMRUQgPSAnZ2MuZW5hYmxlZCc7XG5cbiAgICAvKiogYGhpc3RvcnkuZXhwaXJlLm1heC1zbmFwc2hvdC1hZ2UtbXNgLiAqL1xuICAgIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgSElTVE9SWV9FWFBJUkVfTUFYX1NOQVBTSE9UX0FHRV9NUyA9ICdoaXN0b3J5LmV4cGlyZS5tYXgtc25hcHNob3QtYWdlLW1zJztcblxuICAgIC8qKiBgaGlzdG9yeS5leHBpcmUubWluLXNuYXBzaG90cy10by1rZWVwYC4gKi9cbiAgICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IEhJU1RPUllfRVhQSVJFX01JTl9TTkFQU0hPVFNfVE9fS0VFUCA9ICdoaXN0b3J5LmV4cGlyZS5taW4tc25hcHNob3RzLXRvLWtlZXAnO1xuXG4gICAgLyoqIGBjb21taXQucmV0cnkubnVtLXJldHJpZXNgLiAqL1xuICAgIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgQ09NTUlUX1JFVFJZX05VTV9SRVRSSUVTID0gJ2NvbW1pdC5yZXRyeS5udW0tcmV0cmllcyc7XG59XG5cbmNvbnN0IFBBUlFVRVRfQ09ERUNTID0gbmV3IFNldChbXG4gICAgJ3pzdGQnLFxuICAgICdzbmFwcHknLFxuICAgICdnemlwJyxcbiAgICAnYnJvdGxpJyxcbiAgICAnbHo0JyxcbiAgICAndW5jb21wcmVzc2VkJyxcbl0pO1xuXG5jb25zdCBPUkNfQ09ERUNTID0gbmV3IFNldChbXG4gICAgJ3pzdGQnLFxuICAgICdzbmFwcHknLFxuICAgICd6bGliJyxcbiAgICAnbHo0JyxcbiAgICAnbHpvJyxcbiAgICAnbm9uZScsXG5dKTtcblxuY29uc3QgQVZST19DT0RFQ1MgPSBuZXcgU2V0KFtcbiAgICAnZ3ppcCcsXG4gICAgJ3NuYXBweScsXG4gICAgJ3pzdGQnLFxuICAgICd1bmNvbXByZXNzZWQnLFxuXSk7XG5cbmNvbnN0IFdSSVRFX01PREVTID0gbmV3IFNldChbXG4gICAgJ2NvcHktb24td3JpdGUnLFxuICAgICdtZXJnZS1vbi1yZWFkJyxcbl0pO1xuXG5jb25zdCBESVNUUklCVVRJT05fTU9ERVMgPSBuZXcgU2V0KFtcbiAgICAnbm9uZScsXG4gICAgJ2hhc2gnLFxuICAgICdyYW5nZScsXG5dKTtcblxuY29uc3QgQk9PTEVBTl9WQUxVRVMgPSBuZXcgU2V0KFtcbiAgICAndHJ1ZScsXG4gICAgJ2ZhbHNlJyxcbl0pO1xuXG4vKipcbiAqIFZhbGlkYXRlcyB0aGF0IHRoZSBtZXJnZWQgcHJvcGVydHkgbWFwIGZvciBhIHRhYmxlIGlzIGludGVybmFsbHlcbiAqIGNvbnNpc3RlbnQuIFRocm93cyBgRXJyb3JgIG9uIHRoZSBmaXJzdCBjb25mbGljdCBzbyB0aGUgdXNlciBzZWVzXG4gKiBvbmUgY2xlYXIgbWVzc2FnZSBwZXIgZGVwbG95LlxuICpcbiAqIEBpbnRlcm5hbFxuICovXG5leHBvcnQgZnVuY3Rpb24gdmFsaWRhdGVJY2ViZXJnUHJvcGVydGllcyhcbiAgICBkYXRhRm9ybWF0OiBJY2ViZXJnRGF0YUZvcm1hdCxcbiAgICBmb3JtYXRWZXJzaW9uOiBJY2ViZXJnRm9ybWF0VmVyc2lvbixcbiAgICBwcm9wZXJ0aWVzOiB7IFtrZXk6IHN0cmluZ106IHN0cmluZyB9LFxuKTogdm9pZCB7XG4gICAgLy8vIDEuIHdyaXRlLmZvcm1hdC5kZWZhdWx0IG11c3QgbWF0Y2ggdGhlIGNob3NlbiBkYXRhIGZvcm1hdC5cbiAgICBjb25zdCBkZWNsYXJlZEZvcm1hdCA9IHByb3BlcnRpZXNbSWNlYmVyZ1Byb3BlcnR5S2V5cy5XUklURV9GT1JNQVRfREVGQVVMVF07XG4gICAgaWYgKGRlY2xhcmVkRm9ybWF0ICE9PSB1bmRlZmluZWQgJiYgZGVjbGFyZWRGb3JtYXQgIT09IGRhdGFGb3JtYXQpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICAgICAgYHRhYmxlUHJvcGVydGllc1snJHtJY2ViZXJnUHJvcGVydHlLZXlzLldSSVRFX0ZPUk1BVF9ERUZBVUxUfSddIGlzICcke2RlY2xhcmVkRm9ybWF0fScgYFxuICAgICAgICAgICAgKyBgYnV0IGRhdGFGb3JtYXQgaXMgJyR7ZGF0YUZvcm1hdH0nLiBEcm9wIHRoZSBwcm9wZXJ0eSBvciBjaGFuZ2UgZGF0YUZvcm1hdCB0byBtYXRjaC5gLFxuICAgICAgICApO1xuICAgIH1cblxuICAgIC8vLyAyLiBmb3JtYXQtdmVyc2lvbiBtdXN0IG1hdGNoIHRoZSBjaG9zZW4gZm9ybWF0IHZlcnNpb24uXG4gICAgY29uc3QgZGVjbGFyZWRWZXJzaW9uID0gcHJvcGVydGllc1tJY2ViZXJnUHJvcGVydHlLZXlzLkZPUk1BVF9WRVJTSU9OXTtcbiAgICBpZiAoZGVjbGFyZWRWZXJzaW9uICE9PSB1bmRlZmluZWQgJiYgZGVjbGFyZWRWZXJzaW9uICE9PSBmb3JtYXRWZXJzaW9uKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgICAgIGB0YWJsZVByb3BlcnRpZXNbJyR7SWNlYmVyZ1Byb3BlcnR5S2V5cy5GT1JNQVRfVkVSU0lPTn0nXSBpcyAnJHtkZWNsYXJlZFZlcnNpb259JyBgXG4gICAgICAgICAgICArIGBidXQgZm9ybWF0VmVyc2lvbiBpcyAnJHtmb3JtYXRWZXJzaW9ufScuIERyb3AgdGhlIHByb3BlcnR5IG9yIGNoYW5nZSBmb3JtYXRWZXJzaW9uIHRvIG1hdGNoLmAsXG4gICAgICAgICk7XG4gICAgfVxuXG4gICAgLy8vIDMuIENvbXByZXNzaW9uIGNvZGVjIG11c3QgYmUgdmFsaWQgZm9yIHRoZSBjaG9zZW4gZm9ybWF0IGFuZFxuICAgIC8vLyAgICBtdXN0IGJlIHNldCBvbiB0aGUgY29ycmVjdCBjb2RlYyBrZXkgZm9yIHRoYXQgZm9ybWF0LlxuICAgIHZhbGlkYXRlQ29tcHJlc3Npb25Gb3JGb3JtYXQoZGF0YUZvcm1hdCwgcHJvcGVydGllcyk7XG5cbiAgICAvLy8gNC4gd3JpdGUgbW9kZXMgbXVzdCBiZSB2YWxpZCBJY2ViZXJnIGxpdGVyYWxzLlxuICAgIHZhbGlkYXRlRW51bVByb3BlcnR5KHByb3BlcnRpZXMsIEljZWJlcmdQcm9wZXJ0eUtleXMuV1JJVEVfREVMRVRFX01PREUsIFdSSVRFX01PREVTKTtcbiAgICB2YWxpZGF0ZUVudW1Qcm9wZXJ0eShwcm9wZXJ0aWVzLCBJY2ViZXJnUHJvcGVydHlLZXlzLldSSVRFX1VQREFURV9NT0RFLCBXUklURV9NT0RFUyk7XG4gICAgdmFsaWRhdGVFbnVtUHJvcGVydHkocHJvcGVydGllcywgSWNlYmVyZ1Byb3BlcnR5S2V5cy5XUklURV9NRVJHRV9NT0RFLCBXUklURV9NT0RFUyk7XG4gICAgdmFsaWRhdGVFbnVtUHJvcGVydHkocHJvcGVydGllcywgSWNlYmVyZ1Byb3BlcnR5S2V5cy5XUklURV9ESVNUUklCVVRJT05fTU9ERSwgRElTVFJJQlVUSU9OX01PREVTKTtcblxuICAgIC8vLyA1LiBtZXJnZS1vbi1yZWFkIHJlcXVpcmVzIGZvcm1hdC12ZXJzaW9uIDIgb3IgbGF0ZXIuXG4gICAgaWYgKGZvcm1hdFZlcnNpb24gPT09IEljZWJlcmdGb3JtYXRWZXJzaW9uLlYxKSB7XG4gICAgICAgIGZvciAoY29uc3Qga2V5IG9mIFtcbiAgICAgICAgICAgIEljZWJlcmdQcm9wZXJ0eUtleXMuV1JJVEVfREVMRVRFX01PREUsXG4gICAgICAgICAgICBJY2ViZXJnUHJvcGVydHlLZXlzLldSSVRFX1VQREFURV9NT0RFLFxuICAgICAgICAgICAgSWNlYmVyZ1Byb3BlcnR5S2V5cy5XUklURV9NRVJHRV9NT0RFLFxuICAgICAgICBdKSB7XG4gICAgICAgICAgICBpZiAocHJvcGVydGllc1trZXldID09PSAnbWVyZ2Utb24tcmVhZCcpIHtcbiAgICAgICAgICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgICAgICAgICAgICAgIGB0YWJsZVByb3BlcnRpZXNbJyR7a2V5fSddID0gJ21lcmdlLW9uLXJlYWQnIHJlcXVpcmVzIGZvcm1hdFZlcnNpb24gdjIgb3IgbGF0ZXI7IGdvdCB2MWAsXG4gICAgICAgICAgICAgICAgKTtcbiAgICAgICAgICAgIH1cbiAgICAgICAgfVxuICAgIH1cblxuICAgIC8vLyA2LiBnYy5lbmFibGVkIGlzIGEgYm9vbGVhbi5cbiAgICB2YWxpZGF0ZUVudW1Qcm9wZXJ0eShwcm9wZXJ0aWVzLCBJY2ViZXJnUHJvcGVydHlLZXlzLkdDX0VOQUJMRUQsIEJPT0xFQU5fVkFMVUVTKTtcblxuICAgIC8vLyA3LiBOdW1lcmljIHByb3BlcnRpZXMgbXVzdCBwYXJzZSB0byBwb3NpdGl2ZSBpbnRlZ2Vycy5cbiAgICB2YWxpZGF0ZVBvc2l0aXZlSW50KHByb3BlcnRpZXMsIEljZWJlcmdQcm9wZXJ0eUtleXMuV1JJVEVfVEFSR0VUX0ZJTEVfU0laRV9CWVRFUyk7XG4gICAgdmFsaWRhdGVQb3NpdGl2ZUludChwcm9wZXJ0aWVzLCBJY2ViZXJnUHJvcGVydHlLZXlzLkhJU1RPUllfRVhQSVJFX01BWF9TTkFQU0hPVF9BR0VfTVMpO1xuICAgIHZhbGlkYXRlUG9zaXRpdmVJbnQocHJvcGVydGllcywgSWNlYmVyZ1Byb3BlcnR5S2V5cy5ISVNUT1JZX0VYUElSRV9NSU5fU05BUFNIT1RTX1RPX0tFRVApO1xuICAgIHZhbGlkYXRlUG9zaXRpdmVJbnQocHJvcGVydGllcywgSWNlYmVyZ1Byb3BlcnR5S2V5cy5DT01NSVRfUkVUUllfTlVNX1JFVFJJRVMpO1xufVxuXG5mdW5jdGlvbiB2YWxpZGF0ZUNvbXByZXNzaW9uRm9yRm9ybWF0KFxuICAgIGRhdGFGb3JtYXQ6IEljZWJlcmdEYXRhRm9ybWF0LFxuICAgIHByb3BlcnRpZXM6IHsgW2tleTogc3RyaW5nXTogc3RyaW5nIH0sXG4pOiB2b2lkIHtcbiAgICBjb25zdCBjYW5kaWRhdGVzOiBBcnJheTx7IGtleTogc3RyaW5nOyBhbGxvd2VkOiBSZWFkb25seVNldDxzdHJpbmc+OyBvd25lckZvcm1hdDogSWNlYmVyZ0RhdGFGb3JtYXQgfT4gPSBbXG4gICAgICAgIHtcbiAgICAgICAgICAgIGtleTogSWNlYmVyZ1Byb3BlcnR5S2V5cy5XUklURV9QQVJRVUVUX0NPTVBSRVNTSU9OX0NPREVDLFxuICAgICAgICAgICAgYWxsb3dlZDogUEFSUVVFVF9DT0RFQ1MsXG4gICAgICAgICAgICBvd25lckZvcm1hdDogSWNlYmVyZ0RhdGFGb3JtYXQuUEFSUVVFVCxcbiAgICAgICAgfSxcbiAgICAgICAge1xuICAgICAgICAgICAga2V5OiBJY2ViZXJnUHJvcGVydHlLZXlzLldSSVRFX09SQ19DT01QUkVTU0lPTl9DT0RFQyxcbiAgICAgICAgICAgIGFsbG93ZWQ6IE9SQ19DT0RFQ1MsXG4gICAgICAgICAgICBvd25lckZvcm1hdDogSWNlYmVyZ0RhdGFGb3JtYXQuT1JDLFxuICAgICAgICB9LFxuICAgICAgICB7XG4gICAgICAgICAgICBrZXk6IEljZWJlcmdQcm9wZXJ0eUtleXMuV1JJVEVfQVZST19DT01QUkVTU0lPTl9DT0RFQyxcbiAgICAgICAgICAgIGFsbG93ZWQ6IEFWUk9fQ09ERUNTLFxuICAgICAgICAgICAgb3duZXJGb3JtYXQ6IEljZWJlcmdEYXRhRm9ybWF0LkFWUk8sXG4gICAgICAgIH0sXG4gICAgXTtcbiAgICBmb3IgKGNvbnN0IGNhbmRpZGF0ZSBvZiBjYW5kaWRhdGVzKSB7XG4gICAgICAgIGNvbnN0IHZhbHVlID0gcHJvcGVydGllc1tjYW5kaWRhdGUua2V5XTtcbiAgICAgICAgaWYgKHZhbHVlID09PSB1bmRlZmluZWQpIHtcbiAgICAgICAgICAgIGNvbnRpbnVlO1xuICAgICAgICB9XG4gICAgICAgIGlmIChjYW5kaWRhdGUub3duZXJGb3JtYXQgIT09IGRhdGFGb3JtYXQpIHtcbiAgICAgICAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgICAgICAgICBgdGFibGVQcm9wZXJ0aWVzWycke2NhbmRpZGF0ZS5rZXl9J10gaXMgc2V0IGJ1dCBkYXRhRm9ybWF0IGlzICcke2RhdGFGb3JtYXR9Jy4gYFxuICAgICAgICAgICAgICAgICsgYFRoYXQgY29kZWMga2V5IG9ubHkgYXBwbGllcyB0byAnJHtjYW5kaWRhdGUub3duZXJGb3JtYXR9JyB0YWJsZXMuYCxcbiAgICAgICAgICAgICk7XG4gICAgICAgIH1cbiAgICAgICAgaWYgKCFjYW5kaWRhdGUuYWxsb3dlZC5oYXModmFsdWUpKSB7XG4gICAgICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgICAgICAgICAgYHRhYmxlUHJvcGVydGllc1snJHtjYW5kaWRhdGUua2V5fSddID0gJyR7dmFsdWV9JyBpcyBub3QgYSB2YWxpZCAke2NhbmRpZGF0ZS5vd25lckZvcm1hdH0gYFxuICAgICAgICAgICAgICAgICsgYGNvbXByZXNzaW9uIGNvZGVjLiBBbGxvd2VkOiAke0FycmF5LmZyb20oY2FuZGlkYXRlLmFsbG93ZWQpLnNvcnQoKS5qb2luKCcsICcpfS5gLFxuICAgICAgICAgICAgKTtcbiAgICAgICAgfVxuICAgIH1cbn1cblxuZnVuY3Rpb24gdmFsaWRhdGVFbnVtUHJvcGVydHkoXG4gICAgcHJvcGVydGllczogeyBba2V5OiBzdHJpbmddOiBzdHJpbmcgfSxcbiAgICBrZXk6IHN0cmluZyxcbiAgICBhbGxvd2VkOiBSZWFkb25seVNldDxzdHJpbmc+LFxuKTogdm9pZCB7XG4gICAgY29uc3QgdmFsdWUgPSBwcm9wZXJ0aWVzW2tleV07XG4gICAgaWYgKHZhbHVlICE9PSB1bmRlZmluZWQgJiYgIWFsbG93ZWQuaGFzKHZhbHVlKSkge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgICAgICBgdGFibGVQcm9wZXJ0aWVzWycke2tleX0nXSA9ICcke3ZhbHVlfScgaXMgbm90IHZhbGlkLiBgXG4gICAgICAgICAgICArIGBBbGxvd2VkOiAke0FycmF5LmZyb20oYWxsb3dlZCkuc29ydCgpLmpvaW4oJywgJyl9LmAsXG4gICAgICAgICk7XG4gICAgfVxufVxuXG5mdW5jdGlvbiB2YWxpZGF0ZVBvc2l0aXZlSW50KFxuICAgIHByb3BlcnRpZXM6IHsgW2tleTogc3RyaW5nXTogc3RyaW5nIH0sXG4gICAga2V5OiBzdHJpbmcsXG4pOiB2b2lkIHtcbiAgICBjb25zdCByYXcgPSBwcm9wZXJ0aWVzW2tleV07XG4gICAgaWYgKHJhdyA9PT0gdW5kZWZpbmVkKSB7XG4gICAgICAgIHJldHVybjtcbiAgICB9XG4gICAgaWYgKCEvXlswLTldKyQvLnRlc3QocmF3KSB8fCBOdW1iZXIocmF3KSA8IDEpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICAgICAgYHRhYmxlUHJvcGVydGllc1snJHtrZXl9J10gPSAnJHtyYXd9JyBtdXN0IGJlIGEgcG9zaXRpdmUgaW50ZWdlciBzdHJpbmcuYCxcbiAgICAgICAgKTtcbiAgICB9XG59XG4iXX0=
@@ -40,7 +40,7 @@ var IcebergNullOrder;
40
40
  * leaves the table un-queryable in Athena).
41
41
  */
42
42
  class IcebergTable extends aws_cdk_lib_1.Resource {
43
- static [JSII_RTTI_SYMBOL_1] = { fqn: "cdk-glue-iceberg-table.IcebergTable", version: "0.7.4" };
43
+ static [JSII_RTTI_SYMBOL_1] = { fqn: "cdk-glue-iceberg-table.IcebergTable", version: "0.8.0" };
44
44
  /** Glue ARN of the table. */
45
45
  tableArn;
46
46
  /** Table name as it appears in Glue / Athena. */
@@ -28,7 +28,7 @@ var IcebergTypeKind;
28
28
  * primitives, decimals, fixed, lists, maps, and structs.
29
29
  */
30
30
  class IcebergType {
31
- static [JSII_RTTI_SYMBOL_1] = { fqn: "cdk-glue-iceberg-table.IcebergType", version: "0.7.4" };
31
+ static [JSII_RTTI_SYMBOL_1] = { fqn: "cdk-glue-iceberg-table.IcebergType", version: "0.8.0" };
32
32
  /// Primitives — values from https://iceberg.apache.org/spec/#schemas-and-data-types
33
33
  /** Boolean. */
34
34
  static BOOLEAN = new IcebergType({
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cdk-glue-iceberg-table",
3
- "version": "0.7.4",
3
+ "version": "0.8.0",
4
4
  "license": "MIT",
5
5
  "description": "AWS CDK L2 construct to create and evolve Apache Iceberg tables in the AWS Glue Data Catalog — schema and partition changes that survive CloudFormation updates, via cdk deploy.",
6
6
  "stability": "experimental",