dynamodb-expression-builder 0.1.1 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # dynamodb-expression-builder
 
-DynamoDB expression builder and code generator. Build update, condition, filter and key condition expressions with automatic `ExpressionAttributeNames` / `ExpressionAttributeValues` aliasing — then emit the whole request as runnable code for the JavaScript SDK v3, AWS CLI, boto3 (Python), Java, Go, .NET, PartiQL or [dynamodb-toolbox](https://github.com/dynamodb-toolbox/dynamodb-toolbox). Zero dependencies.
+DynamoDB expression builder and code generator. Build update, condition, filter and key condition expressions with automatic `ExpressionAttributeNames` / `ExpressionAttributeValues` aliasing — then emit the whole request as runnable code for the JavaScript SDK v3, AWS CLI, boto3 (Python), Java, Go, .NET, Rust, PartiQL or [dynamodb-toolbox](https://github.com/dynamodb-toolbox/dynamodb-toolbox). Zero dependencies.
 
 Hand-writing DynamoDB expressions means juggling three coupled structures — the expression string, the `#name` aliases (mandatory whenever an attribute name is one of DynamoDB's 573 reserved words), and the typed `:value` placeholders — and keeping them consistent across every operation. The AWS SDKs for [Go](https://docs.aws.amazon.com/sdk-for-go/) and [Java](https://docs.aws.amazon.com/sdk-for-java/) ship expression builders for this; the JavaScript SDK v3 [does not](https://github.com/aws/aws-sdk-js-v3/issues/3165). This package is that builder, plus something the official ones don't do in any language: code generation, so one structured request becomes a paste-ready command in whichever SDK your team actually runs.
 
@@ -45,7 +45,7 @@ emitSdkV3(request);
 // })
 ```
 
-The same `request` feeds every emitter — `emitCli(request)` gives the `aws dynamodb query \ …` command, `emitBoto3(request)` the Python, `emitJava` / `emitGo` / `emitDotnet` the typed AttributeValue constructors for those SDKs, and `emitPartiql(request)` the equivalent `SELECT` statement (or an honest `{ok: false, reason}` where PartiQL can't express the request).
+The same `request` feeds every emitter — `emitCli(request)` gives the `aws dynamodb query \ …` command, `emitBoto3(request)` the Python, `emitJava` / `emitGo` / `emitDotnet` / `emitRust` the typed AttributeValue constructors for those SDKs, and `emitPartiql(request)` the equivalent `SELECT` statement (or an honest `{ok: false, reason}` where PartiQL can't express the request).
 
 Update expressions compile from a list of actions:
 
@@ -66,7 +66,7 @@ buildUpdateExpression([
 
 SET idioms are first-class: `assign`, `if_not_exists`, atomic counters (`add`/`subtract`), `list_append`/`list_prepend`, plus `REMOVE` (including list elements by index) and `ADD`/`DELETE` for numbers and sets.
 
-And `emitQueryProgram(config, format)` wraps a Query/Scan request into a complete runnable program — client setup, the request, and a `LastEvaluatedKey` pagination loop — with `format` one of `'sdk' | 'cli' | 'boto3' | 'partiql' | 'java' | 'go' | 'dotnet' | 'ddbtoolbox'`.
+And `emitQueryProgram(config, format)` wraps a Query/Scan request into a complete runnable program — client setup, the request, and a `LastEvaluatedKey` pagination loop — with `format` one of `'sdk' | 'cli' | 'boto3' | 'partiql' | 'java' | 'go' | 'dotnet' | 'rust' | 'ddbtoolbox'` (the Rust program paginates with the SDK's `into_paginator()` stream).
 
 ## API
 
@@ -76,7 +76,7 @@ Three layers, each usable on its own:
 | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Model    | `TypedValue`, `makeTypedValue`, `FilterRow`, `KeyAttr`, `RangeKeyCondition`, `UpdateAction`, the `FILTER_OPERATORS` registry + per-type compatibility helpers                       |
 | Builders | `buildRequest(config)` → one `CanonicalRequest` for any of GetItem/Query/Scan/Update/Put/Delete · `buildFilterExpressions` · `buildKeyConditionExpression` · `buildUpdateExpression` |
-| Emitters | `emitSdkV3` · `emitCli` · `emitBoto3` · `emitJava` · `emitGo` · `emitDotnet` · `emitPartiql` · `emitDdbToolboxProgram` · `emitQueryProgram` · `typedMapToAvMap` (tag-driven marshal) |
+| Emitters | `emitSdkV3` · `emitCli` · `emitBoto3` · `emitJava` · `emitGo` · `emitDotnet` · `emitRust` · `emitPartiql` · `emitDdbToolboxProgram` · `emitQueryProgram` · `typedMapToAvMap` (tag-driven marshal) |
 
 Placeholder namespaces never collide: keys use `#hashKey`/`#rangeKey`, filters `#filter{i}`, conditions `#cond{i}`, updates `#upd{i}` — one request can carry a key condition, a filter, a write condition and an update expression simultaneously.
 

package/dist/index.cjs

@@ -154,6 +154,24 @@ const FILTER_OPERATORS = [
 			"L"
 		]
 	},
+	{
+		value: "not_contains",
+		label: "Not Contains",
+		symbol: "∌",
+		wireForm: "NOT_CONTAINS",
+		requiresValue: true,
+		requiresValue2: false,
+		typeOptional: false,
+		keyAllowedTypes: [],
+		scanAllowedTypes: [
+			"S",
+			"B",
+			"SS",
+			"NS",
+			"BS",
+			"L"
+		]
+	},
 	{
 		value: "begins_with",
 		label: "Begins With",
@@ -370,6 +388,9 @@ function buildOne(row, index, prefix, names, typedValues) {
 		case "CONTAINS":
 			typedValues[valueRef] = makeTypedValue(elementType(row.type), row.value);
 			return `contains(${nameRef}, ${valueRef})`;
+		case "NOT_CONTAINS":
+			typedValues[valueRef] = makeTypedValue(elementType(row.type), row.value);
+			return `NOT contains(${nameRef}, ${valueRef})`;
 		case "BEGINS_WITH":
 			typedValues[valueRef] = single$1(row);
 			return `begins_with(${nameRef}, ${valueRef})`;
@@ -967,6 +988,7 @@ function predicate(row) {
 		case "BETWEEN": return `${id} BETWEEN ${literal(makeTypedValue(row.type, row.value))} AND ${literal(makeTypedValue(row.type, row.value2 ?? ""))}`;
 		case "BEGINS_WITH": return `begins_with(${id}, ${literal(single(row))})`;
 		case "CONTAINS": return `contains(${id}, ${literal(makeTypedValue(elementType(row.type), row.value))})`;
+		case "NOT_CONTAINS": return `NOT contains(${id}, ${literal(makeTypedValue(elementType(row.type), row.value))})`;
 		case "IN": return `${id} IN (${(row.values ?? (row.value ? [row.value] : [])).map((m) => literal(makeTypedValue(row.type, m))).join(", ")})`;
 		case "EXISTS": return `${id} IS NOT MISSING`;
 		case "NOT_EXISTS": return `${id} IS MISSING`;
@@ -1095,7 +1117,7 @@ const REQUEST_CLASS_BY_OP$1 = {
 	Delete: "DeleteItemRequest"
 };
 /** Operation → the `DynamoDbClient` method. */
-const CLIENT_METHOD_BY_OP$2 = {
+const CLIENT_METHOD_BY_OP$3 = {
 	GetItem: "getItem",
 	Query: "query",
 	Scan: "scan",
@@ -1109,7 +1131,7 @@ function javaRequestClassName(operation) {
 }
 /** The `DynamoDbClient` method name for an operation (`query`, …). */
 function javaClientMethodName(operation) {
-	return CLIENT_METHOD_BY_OP$2[operation];
+	return CLIENT_METHOD_BY_OP$3[operation];
 }
 /** Java string literal — `JSON.stringify` escapes are all valid Java escapes. */
 function javaString(value) {
@@ -1188,7 +1210,7 @@ const INPUT_TYPE_BY_OP = {
 	Delete: "DeleteItemInput"
 };
 /** Operation → the `dynamodb.Client` method. */
-const CLIENT_METHOD_BY_OP$1 = {
+const CLIENT_METHOD_BY_OP$2 = {
 	GetItem: "GetItem",
 	Query: "Query",
 	Scan: "Scan",
@@ -1202,7 +1224,7 @@ function goInputTypeName(operation) {
 }
 /** The `dynamodb.Client` method name for an operation. */
 function goClientMethodName(operation) {
-	return CLIENT_METHOD_BY_OP$1[operation];
+	return CLIENT_METHOD_BY_OP$2[operation];
 }
 /** Go string literal — `JSON.stringify` escapes are all valid Go escapes. */
 function goString(value) {
@@ -1292,7 +1314,7 @@ const REQUEST_CLASS_BY_OP = {
 	Delete: "DeleteItemRequest"
 };
 /** Operation → the async `AmazonDynamoDBClient` method. */
-const CLIENT_METHOD_BY_OP = {
+const CLIENT_METHOD_BY_OP$1 = {
 	GetItem: "GetItemAsync",
 	Query: "QueryAsync",
 	Scan: "ScanAsync",
@@ -1306,7 +1328,7 @@ function dotnetRequestClassName(operation) {
 }
 /** The async client method name for an operation (`QueryAsync`, …). */
 function dotnetClientMethodName(operation) {
-	return CLIENT_METHOD_BY_OP[operation];
+	return CLIENT_METHOD_BY_OP$1[operation];
 }
 /** C# string literal — `JSON.stringify` escapes are all valid C# escapes. */
 function csString(value) {
@@ -1373,6 +1395,102 @@ function emitDotnet(request) {
 	return renderCsRequest(request, "");
 }
 
+//#endregion
+//#region src/emit/rust.ts
+/** Operation → the `aws_sdk_dynamodb::Client` fluent method. */
+const CLIENT_METHOD_BY_OP = {
+	GetItem: "get_item",
+	Query: "query",
+	Scan: "scan",
+	Update: "update_item",
+	Put: "put_item",
+	Delete: "delete_item"
+};
+/** The `Client` method name (snake_case) for an operation. */
+function rustClientMethodName(operation) {
+	return CLIENT_METHOD_BY_OP[operation];
+}
+/** Rust string literal — JSON escapes with the three Rust-incompatible ones fixed. */
+function rustString(value) {
+	return JSON.stringify(value).replace(/\\b/g, "\\u{0008}").replace(/\\f/g, "\\u{000c}").replace(/\\u([0-9a-fA-F]{4})/g, "\\u{$1}");
+}
+/** `"…".to_string()` — the owned String the AttributeValue constructors take. */
+function rustOwned(value) {
+	return `${rustString(value)}.to_string()`;
+}
+/** Decode canonical base64 into a `Blob::new(vec![0x…])` (fail-loud on bad input). */
+function rustBlob(base64) {
+	let raw;
+	try {
+		raw = atob(base64);
+	} catch {
+		throw new Error(`invalid base64 in a binary (B/BS) value: ${base64}`);
+	}
+	return `Blob::new(vec![${Array.from(raw, (c) => `0x${c.charCodeAt(0).toString(16).padStart(2, "0")}`).join(", ")}])`;
+}
+/** Render one wire AttributeValue as an `AttributeValue::…` constructor. */
+function renderRustAv(av) {
+	if ("S" in av) return `AttributeValue::S(${rustOwned(av.S)})`;
+	if ("N" in av) return `AttributeValue::N(${rustOwned(av.N)})`;
+	if ("B" in av) return `AttributeValue::B(${rustBlob(av.B)})`;
+	if ("BOOL" in av) return `AttributeValue::Bool(${av.BOOL})`;
+	if ("SS" in av) return `AttributeValue::Ss(vec![${av.SS.map(rustOwned).join(", ")}])`;
+	if ("NS" in av) return `AttributeValue::Ns(vec![${av.NS.map(rustOwned).join(", ")}])`;
+	if ("BS" in av) return `AttributeValue::Bs(vec![${av.BS.map(rustBlob).join(", ")}])`;
+	return "AttributeValue::Null(true)";
+}
+/** One `.method(key, av)` line per entry of a typed map. */
+function avEntryLines(method, map, indent) {
+	return Object.entries(typedMapToAvMap(map)).map(([name, av]) => `${indent}.${method}(${rustString(name)}, ${renderRustAv(av)})`);
+}
+/**
+* Render the fluent builder chain for a request — every line at `indent`,
+* starting with `.{op}()` and ending BEFORE `.send()` so callers own the
+* terminal (the bare emitter awaits inline; the program emitter may hand the
+* chain to `into_paginator()` instead). Exported for the program emitter.
+*/
+function renderRustBuilder(request, indent) {
+	const lines = [`${indent}.${CLIENT_METHOD_BY_OP[request.operation]}()`];
+	lines.push(`${indent}.table_name(${rustString(request.tableName)})`);
+	if (request.indexName) lines.push(`${indent}.index_name(${rustString(request.indexName)})`);
+	if (request.key) lines.push(...avEntryLines("key", request.key, indent));
+	if (request.item) lines.push(...avEntryLines("item", request.item, indent));
+	if (request.keyConditionExpression) lines.push(`${indent}.key_condition_expression(${rustString(request.keyConditionExpression)})`);
+	if (request.updateExpression) lines.push(`${indent}.update_expression(${rustString(request.updateExpression)})`);
+	if (request.conditionExpression) lines.push(`${indent}.condition_expression(${rustString(request.conditionExpression)})`);
+	if (request.filterExpression) lines.push(`${indent}.filter_expression(${rustString(request.filterExpression)})`);
+	if (request.projectionExpression) lines.push(`${indent}.projection_expression(${rustString(request.projectionExpression)})`);
+	if (request.names) lines.push(...Object.entries(request.names).map(([alias, name]) => `${indent}.expression_attribute_names(${rustString(alias)}, ${rustString(name)})`));
+	if (request.typedValues) lines.push(...avEntryLines("expression_attribute_values", request.typedValues, indent));
+	if (request.limit !== void 0) lines.push(`${indent}.limit(${request.limit})`);
+	if (request.consistentRead) lines.push(`${indent}.consistent_read(true)`);
+	if (request.scanIndexForward === false) lines.push(`${indent}.scan_index_forward(false)`);
+	if (request.exclusiveStartKey) lines.push(...avEntryLines("exclusive_start_key", request.exclusiveStartKey, indent));
+	return lines;
+}
+/** Does this request build any `AttributeValue`? Drives the program emitter's imports. */
+function rustUsesAttributeValue(request) {
+	return request.key !== void 0 || request.item !== void 0 || request.typedValues !== void 0 || request.exclusiveStartKey !== void 0;
+}
+/** Does this request build any binary Blob? Drives the `primitives::Blob` import. */
+function rustUsesBlob(request) {
+	return [
+		request.key,
+		request.item,
+		request.typedValues,
+		request.exclusiveStartKey
+	].some((map) => map && Object.values(typedMapToAvMap(map)).some((av) => "B" in av || "BS" in av));
+}
+/** Emit the bare fluent call for a canonical request (awaited, `?`-propagated). */
+function emitRust(request) {
+	return [
+		"let response = client",
+		...renderRustBuilder(request, "    "),
+		"    .send()",
+		"    .await?;"
+	].join("\n");
+}
+
 //#endregion
 //#region src/emit/ddbtoolbox.ts
 /** Key attr DynamoDB type (S/N/B) → the Table `type` string dynamodb-toolbox wants. */
@@ -1438,6 +1556,7 @@ function renderCondition(f) {
 	if (f.operator === "exists") return `{ attr: ${attr}, exists: true }`;
 	if (f.operator === "not_exists") return `{ attr: ${attr}, exists: false }`;
 	if (f.operator === "contains") return `{ attr: ${attr}, contains: ${val()} }`;
+	if (f.operator === "not_contains") return `{ not: { attr: ${attr}, contains: ${val()} } }`;
 	if (f.operator === "begins_with") return `{ attr: ${attr}, beginsWith: ${val()} }`;
 	if (f.operator === "between") return `{ attr: ${attr}, between: [${renderNativeValue(scalar(f.type, f.value))}, ${renderNativeValue(scalar(f.type, f.value2 ?? ""))}] }`;
 	if (f.operator === "in") return `{ attr: ${attr}, in: [${(f.values ?? []).map((v) => renderNativeValue(scalar(f.type, v))).join(", ")}] }`;
@@ -1627,6 +1746,10 @@ function emitQueryProgram(config, format) {
 			ok: true,
 			code: emitDotnetProgram(request, config.paginate === true)
 		};
+		case "rust": return {
+			ok: true,
+			code: emitRustProgram(request, config.paginate === true)
+		};
 		case "ddbtoolbox": return {
 			ok: true,
 			code: emitDdbToolboxProgram(request, config.paginate === true)
@@ -1824,6 +1947,51 @@ function emitGoProgram(request, paginate) {
 		"}"
 	].join("\n");
 }
+function emitRustProgram(request, paginate) {
+	const usesAv = rustUsesAttributeValue(request);
+	const usesBlob = rustUsesBlob(request);
+	const header = [
+		...[
+			"// Cargo.toml: aws-config, aws-sdk-dynamodb, tokio (features = [\"full\"])",
+			"use aws_sdk_dynamodb::Client;",
+			...usesAv ? ["use aws_sdk_dynamodb::types::AttributeValue;"] : [],
+			...usesBlob ? ["use aws_sdk_dynamodb::primitives::Blob;"] : []
+		],
+		"",
+		"#[tokio::main]",
+		"async fn main() -> Result<(), aws_sdk_dynamodb::Error> {",
+		"    let config = aws_config::load_from_env().await;",
+		"    let client = Client::new(&config);",
+		""
+	];
+	const builder = renderRustBuilder(request, "        ");
+	if (!paginate) return [
+		...header,
+		"    let response = client",
+		...builder,
+		"        .send()",
+		"        .await?;",
+		"    println!(\"{:?}\", response.items());",
+		"",
+		"    Ok(())",
+		"}"
+	].join("\n");
+	return [
+		...header,
+		"    let mut items = client",
+		...builder,
+		"        .into_paginator()",
+		"        .items()",
+		"        .send();",
+		"",
+		"    while let Some(item) = items.next().await {",
+		"        println!(\"{:?}\", item?);",
+		"    }",
+		"",
+		"    Ok(())",
+		"}"
+	].join("\n");
+}
 function emitDotnetProgram(request, paginate) {
 	const method = dotnetClientMethodName(request.operation);
 	const binary = hasBinaryValue(request);
@@ -1891,6 +2059,7 @@ exports.emitGo = emitGo;
 exports.emitJava = emitJava;
 exports.emitPartiql = emitPartiql;
 exports.emitQueryProgram = emitQueryProgram;
+exports.emitRust = emitRust;
 exports.emitSdkV3 = emitSdkV3;
 exports.getCompatibleComparisonOperators = getCompatibleComparisonOperators;
 exports.getCompatibleFilterOperators = getCompatibleFilterOperators;
@@ -1903,6 +2072,8 @@ exports.javaRequestClassName = javaRequestClassName;
 exports.makeTypedValue = makeTypedValue;
 exports.renderJsValue = renderJsValue;
 exports.renderPyValue = renderPyValue;
+exports.renderRustAv = renderRustAv;
+exports.rustClientMethodName = rustClientMethodName;
 exports.sdkV3CommandName = sdkV3CommandName;
 exports.typedMapToAvMap = typedMapToAvMap;
 exports.typedValueToAv = typedValueToAv;

package/dist/index.d.cts

@@ -3,7 +3,7 @@
  * Wire-format (uppercase) operator union. INLINED copy of the app's
  * `WireFilterOperator` (`src/schemas/dynamodb-schemas.ts`).
  */
-type WireFilterOperator = 'EQ' | 'NE' | 'GT' | 'GE' | 'LT' | 'LE' | 'CONTAINS' | 'BEGINS_WITH' | 'BETWEEN' | 'IN' | 'EXISTS' | 'NOT_EXISTS' | 'SIZE_EQ' | 'SIZE_NE' | 'SIZE_LT' | 'SIZE_LE' | 'SIZE_GT' | 'SIZE_GE' | 'TYPE_EQ' | 'TYPE_NE';
+type WireFilterOperator = 'EQ' | 'NE' | 'GT' | 'GE' | 'LT' | 'LE' | 'CONTAINS' | 'NOT_CONTAINS' | 'BEGINS_WITH' | 'BETWEEN' | 'IN' | 'EXISTS' | 'NOT_EXISTS' | 'SIZE_EQ' | 'SIZE_NE' | 'SIZE_LT' | 'SIZE_LE' | 'SIZE_GT' | 'SIZE_GE' | 'TYPE_EQ' | 'TYPE_NE';
 /**
  * Data types the compat map reasons about. `L`/`M` are included even though the
  * tool's Type selector doesn't expose them — they keep the compat table a
@@ -101,6 +101,16 @@ declare const FILTER_OPERATORS: readonly [{
   readonly typeOptional: false;
   readonly keyAllowedTypes: readonly [];
   readonly scanAllowedTypes: readonly ["S", "B", "SS", "NS", "BS", "L"];
+}, {
+  readonly value: "not_contains";
+  readonly label: "Not Contains";
+  readonly symbol: "∌";
+  readonly wireForm: "NOT_CONTAINS";
+  readonly requiresValue: true;
+  readonly requiresValue2: false;
+  readonly typeOptional: false;
+  readonly keyAllowedTypes: readonly [];
+  readonly scanAllowedTypes: readonly ["S", "B", "SS", "NS", "BS", "L"];
 }, {
   readonly value: "begins_with";
   readonly label: "Begins With";
@@ -600,6 +610,14 @@ declare function dotnetClientMethodName(operation: DdbOperation): string;
 /** Emit the bare `new <Op>Request { … }` snippet for a canonical request. */
 declare function emitDotnet(request: CanonicalRequest): string;
 //#endregion
+//#region src/emit/rust.d.ts
+/** The `Client` method name (snake_case) for an operation. */
+declare function rustClientMethodName(operation: DdbOperation): string;
+/** Render one wire AttributeValue as an `AttributeValue::…` constructor. */
+declare function renderRustAv(av: AttributeValue): string;
+/** Emit the bare fluent call for a canonical request (awaited, `?`-propagated). */
+declare function emitRust(request: CanonicalRequest): string;
+//#endregion
 //#region src/emit/ddbtoolbox.d.ts
 /**
  * Emit the runnable dynamodb-toolbox program for a Query/Scan canonical request.
@@ -618,7 +636,7 @@ interface QueryToolConfig extends BuilderConfig {
   /** Emit the fetch-all-pages pagination loop (default: single request). */
   paginate?: boolean;
 }
-type QueryProgramFormat = 'sdk' | 'cli' | 'boto3' | 'partiql' | 'java' | 'go' | 'dotnet' | 'ddbtoolbox';
+type QueryProgramFormat = 'sdk' | 'cli' | 'boto3' | 'partiql' | 'java' | 'go' | 'dotnet' | 'rust' | 'ddbtoolbox';
 /** A runnable program, or an honest reason the format can't express it. */
 type ProgramResult = {
   ok: true;
@@ -636,4 +654,4 @@ type ProgramResult = {
  */
 declare function emitQueryProgram(config: QueryToolConfig, format: QueryProgramFormat): ProgramResult;
 //#endregion
-export { type AttributeValue, type BuilderConfig, type CanonicalRequest, type DdbOperation, type DdbScalarType, FILTER_OPERATORS, type FilterDataType, type FilterOperatorOption, type FilterRow, type ItemAttr, KEY_OPERATORS, type KeyAttr, type KeyConditionResult, OPERATOR_BY_VALUE, type OperatorDef, type OperatorValue, type PartiqlResult, type PredicateExpression, type PredicatePrefix, type ProgramResult, type QueryProgramFormat, type QueryToolConfig, type RangeKeyCondition, SET_TYPES, type SetOperation, type SetType, type TypedValue, type UpdateAction, type UpdateActionKind, type UpdateExpressionResult, type WireFilterOperator, boto3MethodName, buildFilterExpressions, buildKeyConditionExpression, buildKeyMap, buildRequest, buildSdkV3Params, buildUpdateExpression, dotnetClientMethodName, dotnetRequestClassName, elementType, emitBoto3, emitCli, emitDdbToolboxProgram, emitDotnet, emitGo, emitJava, emitPartiql, emitQueryProgram, emitSdkV3, getCompatibleComparisonOperators, getCompatibleFilterOperators, goClientMethodName, goInputTypeName, hasBinaryValue, isSetType, javaClientMethodName, javaRequestClassName, makeTypedValue, renderJsValue, renderPyValue, sdkV3CommandName, typedMapToAvMap, typedValueToAv };
+export { type AttributeValue, type BuilderConfig, type CanonicalRequest, type DdbOperation, type DdbScalarType, FILTER_OPERATORS, type FilterDataType, type FilterOperatorOption, type FilterRow, type ItemAttr, KEY_OPERATORS, type KeyAttr, type KeyConditionResult, OPERATOR_BY_VALUE, type OperatorDef, type OperatorValue, type PartiqlResult, type PredicateExpression, type PredicatePrefix, type ProgramResult, type QueryProgramFormat, type QueryToolConfig, type RangeKeyCondition, SET_TYPES, type SetOperation, type SetType, type TypedValue, type UpdateAction, type UpdateActionKind, type UpdateExpressionResult, type WireFilterOperator, boto3MethodName, buildFilterExpressions, buildKeyConditionExpression, buildKeyMap, buildRequest, buildSdkV3Params, buildUpdateExpression, dotnetClientMethodName, dotnetRequestClassName, elementType, emitBoto3, emitCli, emitDdbToolboxProgram, emitDotnet, emitGo, emitJava, emitPartiql, emitQueryProgram, emitRust, emitSdkV3, getCompatibleComparisonOperators, getCompatibleFilterOperators, goClientMethodName, goInputTypeName, hasBinaryValue, isSetType, javaClientMethodName, javaRequestClassName, makeTypedValue, renderJsValue, renderPyValue, renderRustAv, rustClientMethodName, sdkV3CommandName, typedMapToAvMap, typedValueToAv };

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  * Wire-format (uppercase) operator union. INLINED copy of the app's
  * `WireFilterOperator` (`src/schemas/dynamodb-schemas.ts`).
  */
-type WireFilterOperator = 'EQ' | 'NE' | 'GT' | 'GE' | 'LT' | 'LE' | 'CONTAINS' | 'BEGINS_WITH' | 'BETWEEN' | 'IN' | 'EXISTS' | 'NOT_EXISTS' | 'SIZE_EQ' | 'SIZE_NE' | 'SIZE_LT' | 'SIZE_LE' | 'SIZE_GT' | 'SIZE_GE' | 'TYPE_EQ' | 'TYPE_NE';
+type WireFilterOperator = 'EQ' | 'NE' | 'GT' | 'GE' | 'LT' | 'LE' | 'CONTAINS' | 'NOT_CONTAINS' | 'BEGINS_WITH' | 'BETWEEN' | 'IN' | 'EXISTS' | 'NOT_EXISTS' | 'SIZE_EQ' | 'SIZE_NE' | 'SIZE_LT' | 'SIZE_LE' | 'SIZE_GT' | 'SIZE_GE' | 'TYPE_EQ' | 'TYPE_NE';
 /**
  * Data types the compat map reasons about. `L`/`M` are included even though the
  * tool's Type selector doesn't expose them — they keep the compat table a
@@ -101,6 +101,16 @@ declare const FILTER_OPERATORS: readonly [{
   readonly typeOptional: false;
   readonly keyAllowedTypes: readonly [];
   readonly scanAllowedTypes: readonly ["S", "B", "SS", "NS", "BS", "L"];
+}, {
+  readonly value: "not_contains";
+  readonly label: "Not Contains";
+  readonly symbol: "∌";
+  readonly wireForm: "NOT_CONTAINS";
+  readonly requiresValue: true;
+  readonly requiresValue2: false;
+  readonly typeOptional: false;
+  readonly keyAllowedTypes: readonly [];
+  readonly scanAllowedTypes: readonly ["S", "B", "SS", "NS", "BS", "L"];
 }, {
   readonly value: "begins_with";
   readonly label: "Begins With";
@@ -600,6 +610,14 @@ declare function dotnetClientMethodName(operation: DdbOperation): string;
 /** Emit the bare `new <Op>Request { … }` snippet for a canonical request. */
 declare function emitDotnet(request: CanonicalRequest): string;
 //#endregion
+//#region src/emit/rust.d.ts
+/** The `Client` method name (snake_case) for an operation. */
+declare function rustClientMethodName(operation: DdbOperation): string;
+/** Render one wire AttributeValue as an `AttributeValue::…` constructor. */
+declare function renderRustAv(av: AttributeValue): string;
+/** Emit the bare fluent call for a canonical request (awaited, `?`-propagated). */
+declare function emitRust(request: CanonicalRequest): string;
+//#endregion
 //#region src/emit/ddbtoolbox.d.ts
 /**
  * Emit the runnable dynamodb-toolbox program for a Query/Scan canonical request.
@@ -618,7 +636,7 @@ interface QueryToolConfig extends BuilderConfig {
   /** Emit the fetch-all-pages pagination loop (default: single request). */
   paginate?: boolean;
 }
-type QueryProgramFormat = 'sdk' | 'cli' | 'boto3' | 'partiql' | 'java' | 'go' | 'dotnet' | 'ddbtoolbox';
+type QueryProgramFormat = 'sdk' | 'cli' | 'boto3' | 'partiql' | 'java' | 'go' | 'dotnet' | 'rust' | 'ddbtoolbox';
 /** A runnable program, or an honest reason the format can't express it. */
 type ProgramResult = {
   ok: true;
@@ -636,4 +654,4 @@ type ProgramResult = {
  */
 declare function emitQueryProgram(config: QueryToolConfig, format: QueryProgramFormat): ProgramResult;
 //#endregion
-export { type AttributeValue, type BuilderConfig, type CanonicalRequest, type DdbOperation, type DdbScalarType, FILTER_OPERATORS, type FilterDataType, type FilterOperatorOption, type FilterRow, type ItemAttr, KEY_OPERATORS, type KeyAttr, type KeyConditionResult, OPERATOR_BY_VALUE, type OperatorDef, type OperatorValue, type PartiqlResult, type PredicateExpression, type PredicatePrefix, type ProgramResult, type QueryProgramFormat, type QueryToolConfig, type RangeKeyCondition, SET_TYPES, type SetOperation, type SetType, type TypedValue, type UpdateAction, type UpdateActionKind, type UpdateExpressionResult, type WireFilterOperator, boto3MethodName, buildFilterExpressions, buildKeyConditionExpression, buildKeyMap, buildRequest, buildSdkV3Params, buildUpdateExpression, dotnetClientMethodName, dotnetRequestClassName, elementType, emitBoto3, emitCli, emitDdbToolboxProgram, emitDotnet, emitGo, emitJava, emitPartiql, emitQueryProgram, emitSdkV3, getCompatibleComparisonOperators, getCompatibleFilterOperators, goClientMethodName, goInputTypeName, hasBinaryValue, isSetType, javaClientMethodName, javaRequestClassName, makeTypedValue, renderJsValue, renderPyValue, sdkV3CommandName, typedMapToAvMap, typedValueToAv };
+export { type AttributeValue, type BuilderConfig, type CanonicalRequest, type DdbOperation, type DdbScalarType, FILTER_OPERATORS, type FilterDataType, type FilterOperatorOption, type FilterRow, type ItemAttr, KEY_OPERATORS, type KeyAttr, type KeyConditionResult, OPERATOR_BY_VALUE, type OperatorDef, type OperatorValue, type PartiqlResult, type PredicateExpression, type PredicatePrefix, type ProgramResult, type QueryProgramFormat, type QueryToolConfig, type RangeKeyCondition, SET_TYPES, type SetOperation, type SetType, type TypedValue, type UpdateAction, type UpdateActionKind, type UpdateExpressionResult, type WireFilterOperator, boto3MethodName, buildFilterExpressions, buildKeyConditionExpression, buildKeyMap, buildRequest, buildSdkV3Params, buildUpdateExpression, dotnetClientMethodName, dotnetRequestClassName, elementType, emitBoto3, emitCli, emitDdbToolboxProgram, emitDotnet, emitGo, emitJava, emitPartiql, emitQueryProgram, emitRust, emitSdkV3, getCompatibleComparisonOperators, getCompatibleFilterOperators, goClientMethodName, goInputTypeName, hasBinaryValue, isSetType, javaClientMethodName, javaRequestClassName, makeTypedValue, renderJsValue, renderPyValue, renderRustAv, rustClientMethodName, sdkV3CommandName, typedMapToAvMap, typedValueToAv };

package/dist/index.js

@@ -153,6 +153,24 @@ const FILTER_OPERATORS = [
 			"L"
 		]
 	},
+	{
+		value: "not_contains",
+		label: "Not Contains",
+		symbol: "∌",
+		wireForm: "NOT_CONTAINS",
+		requiresValue: true,
+		requiresValue2: false,
+		typeOptional: false,
+		keyAllowedTypes: [],
+		scanAllowedTypes: [
+			"S",
+			"B",
+			"SS",
+			"NS",
+			"BS",
+			"L"
+		]
+	},
 	{
 		value: "begins_with",
 		label: "Begins With",
@@ -369,6 +387,9 @@ function buildOne(row, index, prefix, names, typedValues) {
 		case "CONTAINS":
 			typedValues[valueRef] = makeTypedValue(elementType(row.type), row.value);
 			return `contains(${nameRef}, ${valueRef})`;
+		case "NOT_CONTAINS":
+			typedValues[valueRef] = makeTypedValue(elementType(row.type), row.value);
+			return `NOT contains(${nameRef}, ${valueRef})`;
 		case "BEGINS_WITH":
 			typedValues[valueRef] = single$1(row);
 			return `begins_with(${nameRef}, ${valueRef})`;
@@ -966,6 +987,7 @@ function predicate(row) {
 		case "BETWEEN": return `${id} BETWEEN ${literal(makeTypedValue(row.type, row.value))} AND ${literal(makeTypedValue(row.type, row.value2 ?? ""))}`;
 		case "BEGINS_WITH": return `begins_with(${id}, ${literal(single(row))})`;
 		case "CONTAINS": return `contains(${id}, ${literal(makeTypedValue(elementType(row.type), row.value))})`;
+		case "NOT_CONTAINS": return `NOT contains(${id}, ${literal(makeTypedValue(elementType(row.type), row.value))})`;
 		case "IN": return `${id} IN (${(row.values ?? (row.value ? [row.value] : [])).map((m) => literal(makeTypedValue(row.type, m))).join(", ")})`;
 		case "EXISTS": return `${id} IS NOT MISSING`;
 		case "NOT_EXISTS": return `${id} IS MISSING`;
@@ -1094,7 +1116,7 @@ const REQUEST_CLASS_BY_OP$1 = {
 	Delete: "DeleteItemRequest"
 };
 /** Operation → the `DynamoDbClient` method. */
-const CLIENT_METHOD_BY_OP$2 = {
+const CLIENT_METHOD_BY_OP$3 = {
 	GetItem: "getItem",
 	Query: "query",
 	Scan: "scan",
@@ -1108,7 +1130,7 @@ function javaRequestClassName(operation) {
 }
 /** The `DynamoDbClient` method name for an operation (`query`, …). */
 function javaClientMethodName(operation) {
-	return CLIENT_METHOD_BY_OP$2[operation];
+	return CLIENT_METHOD_BY_OP$3[operation];
 }
 /** Java string literal — `JSON.stringify` escapes are all valid Java escapes. */
 function javaString(value) {
@@ -1187,7 +1209,7 @@ const INPUT_TYPE_BY_OP = {
 	Delete: "DeleteItemInput"
 };
 /** Operation → the `dynamodb.Client` method. */
-const CLIENT_METHOD_BY_OP$1 = {
+const CLIENT_METHOD_BY_OP$2 = {
 	GetItem: "GetItem",
 	Query: "Query",
 	Scan: "Scan",
@@ -1201,7 +1223,7 @@ function goInputTypeName(operation) {
 }
 /** The `dynamodb.Client` method name for an operation. */
 function goClientMethodName(operation) {
-	return CLIENT_METHOD_BY_OP$1[operation];
+	return CLIENT_METHOD_BY_OP$2[operation];
 }
 /** Go string literal — `JSON.stringify` escapes are all valid Go escapes. */
 function goString(value) {
@@ -1291,7 +1313,7 @@ const REQUEST_CLASS_BY_OP = {
 	Delete: "DeleteItemRequest"
 };
 /** Operation → the async `AmazonDynamoDBClient` method. */
-const CLIENT_METHOD_BY_OP = {
+const CLIENT_METHOD_BY_OP$1 = {
 	GetItem: "GetItemAsync",
 	Query: "QueryAsync",
 	Scan: "ScanAsync",
@@ -1305,7 +1327,7 @@ function dotnetRequestClassName(operation) {
 }
 /** The async client method name for an operation (`QueryAsync`, …). */
 function dotnetClientMethodName(operation) {
-	return CLIENT_METHOD_BY_OP[operation];
+	return CLIENT_METHOD_BY_OP$1[operation];
 }
 /** C# string literal — `JSON.stringify` escapes are all valid C# escapes. */
 function csString(value) {
@@ -1372,6 +1394,102 @@ function emitDotnet(request) {
 	return renderCsRequest(request, "");
 }
 
+//#endregion
+//#region src/emit/rust.ts
+/** Operation → the `aws_sdk_dynamodb::Client` fluent method. */
+const CLIENT_METHOD_BY_OP = {
+	GetItem: "get_item",
+	Query: "query",
+	Scan: "scan",
+	Update: "update_item",
+	Put: "put_item",
+	Delete: "delete_item"
+};
+/** The `Client` method name (snake_case) for an operation. */
+function rustClientMethodName(operation) {
+	return CLIENT_METHOD_BY_OP[operation];
+}
+/** Rust string literal — JSON escapes with the three Rust-incompatible ones fixed. */
+function rustString(value) {
+	return JSON.stringify(value).replace(/\\b/g, "\\u{0008}").replace(/\\f/g, "\\u{000c}").replace(/\\u([0-9a-fA-F]{4})/g, "\\u{$1}");
+}
+/** `"…".to_string()` — the owned String the AttributeValue constructors take. */
+function rustOwned(value) {
+	return `${rustString(value)}.to_string()`;
+}
+/** Decode canonical base64 into a `Blob::new(vec![0x…])` (fail-loud on bad input). */
+function rustBlob(base64) {
+	let raw;
+	try {
+		raw = atob(base64);
+	} catch {
+		throw new Error(`invalid base64 in a binary (B/BS) value: ${base64}`);
+	}
+	return `Blob::new(vec![${Array.from(raw, (c) => `0x${c.charCodeAt(0).toString(16).padStart(2, "0")}`).join(", ")}])`;
+}
+/** Render one wire AttributeValue as an `AttributeValue::…` constructor. */
+function renderRustAv(av) {
+	if ("S" in av) return `AttributeValue::S(${rustOwned(av.S)})`;
+	if ("N" in av) return `AttributeValue::N(${rustOwned(av.N)})`;
+	if ("B" in av) return `AttributeValue::B(${rustBlob(av.B)})`;
+	if ("BOOL" in av) return `AttributeValue::Bool(${av.BOOL})`;
+	if ("SS" in av) return `AttributeValue::Ss(vec![${av.SS.map(rustOwned).join(", ")}])`;
+	if ("NS" in av) return `AttributeValue::Ns(vec![${av.NS.map(rustOwned).join(", ")}])`;
+	if ("BS" in av) return `AttributeValue::Bs(vec![${av.BS.map(rustBlob).join(", ")}])`;
+	return "AttributeValue::Null(true)";
+}
+/** One `.method(key, av)` line per entry of a typed map. */
+function avEntryLines(method, map, indent) {
+	return Object.entries(typedMapToAvMap(map)).map(([name, av]) => `${indent}.${method}(${rustString(name)}, ${renderRustAv(av)})`);
+}
+/**
+* Render the fluent builder chain for a request — every line at `indent`,
+* starting with `.{op}()` and ending BEFORE `.send()` so callers own the
+* terminal (the bare emitter awaits inline; the program emitter may hand the
+* chain to `into_paginator()` instead). Exported for the program emitter.
+*/
+function renderRustBuilder(request, indent) {
+	const lines = [`${indent}.${CLIENT_METHOD_BY_OP[request.operation]}()`];
+	lines.push(`${indent}.table_name(${rustString(request.tableName)})`);
+	if (request.indexName) lines.push(`${indent}.index_name(${rustString(request.indexName)})`);
+	if (request.key) lines.push(...avEntryLines("key", request.key, indent));
+	if (request.item) lines.push(...avEntryLines("item", request.item, indent));
+	if (request.keyConditionExpression) lines.push(`${indent}.key_condition_expression(${rustString(request.keyConditionExpression)})`);
+	if (request.updateExpression) lines.push(`${indent}.update_expression(${rustString(request.updateExpression)})`);
+	if (request.conditionExpression) lines.push(`${indent}.condition_expression(${rustString(request.conditionExpression)})`);
+	if (request.filterExpression) lines.push(`${indent}.filter_expression(${rustString(request.filterExpression)})`);
+	if (request.projectionExpression) lines.push(`${indent}.projection_expression(${rustString(request.projectionExpression)})`);
+	if (request.names) lines.push(...Object.entries(request.names).map(([alias, name]) => `${indent}.expression_attribute_names(${rustString(alias)}, ${rustString(name)})`));
+	if (request.typedValues) lines.push(...avEntryLines("expression_attribute_values", request.typedValues, indent));
+	if (request.limit !== void 0) lines.push(`${indent}.limit(${request.limit})`);
+	if (request.consistentRead) lines.push(`${indent}.consistent_read(true)`);
+	if (request.scanIndexForward === false) lines.push(`${indent}.scan_index_forward(false)`);
+	if (request.exclusiveStartKey) lines.push(...avEntryLines("exclusive_start_key", request.exclusiveStartKey, indent));
+	return lines;
+}
+/** Does this request build any `AttributeValue`? Drives the program emitter's imports. */
+function rustUsesAttributeValue(request) {
+	return request.key !== void 0 || request.item !== void 0 || request.typedValues !== void 0 || request.exclusiveStartKey !== void 0;
+}
+/** Does this request build any binary Blob? Drives the `primitives::Blob` import. */
+function rustUsesBlob(request) {
+	return [
+		request.key,
+		request.item,
+		request.typedValues,
+		request.exclusiveStartKey
+	].some((map) => map && Object.values(typedMapToAvMap(map)).some((av) => "B" in av || "BS" in av));
+}
+/** Emit the bare fluent call for a canonical request (awaited, `?`-propagated). */
+function emitRust(request) {
+	return [
+		"let response = client",
+		...renderRustBuilder(request, "    "),
+		"    .send()",
+		"    .await?;"
+	].join("\n");
+}
+
 //#endregion
 //#region src/emit/ddbtoolbox.ts
 /** Key attr DynamoDB type (S/N/B) → the Table `type` string dynamodb-toolbox wants. */
@@ -1437,6 +1555,7 @@ function renderCondition(f) {
 	if (f.operator === "exists") return `{ attr: ${attr}, exists: true }`;
 	if (f.operator === "not_exists") return `{ attr: ${attr}, exists: false }`;
 	if (f.operator === "contains") return `{ attr: ${attr}, contains: ${val()} }`;
+	if (f.operator === "not_contains") return `{ not: { attr: ${attr}, contains: ${val()} } }`;
 	if (f.operator === "begins_with") return `{ attr: ${attr}, beginsWith: ${val()} }`;
 	if (f.operator === "between") return `{ attr: ${attr}, between: [${renderNativeValue(scalar(f.type, f.value))}, ${renderNativeValue(scalar(f.type, f.value2 ?? ""))}] }`;
 	if (f.operator === "in") return `{ attr: ${attr}, in: [${(f.values ?? []).map((v) => renderNativeValue(scalar(f.type, v))).join(", ")}] }`;
@@ -1626,6 +1745,10 @@ function emitQueryProgram(config, format) {
 			ok: true,
 			code: emitDotnetProgram(request, config.paginate === true)
 		};
+		case "rust": return {
+			ok: true,
+			code: emitRustProgram(request, config.paginate === true)
+		};
 		case "ddbtoolbox": return {
 			ok: true,
 			code: emitDdbToolboxProgram(request, config.paginate === true)
@@ -1823,6 +1946,51 @@ function emitGoProgram(request, paginate) {
 		"}"
 	].join("\n");
 }
+function emitRustProgram(request, paginate) {
+	const usesAv = rustUsesAttributeValue(request);
+	const usesBlob = rustUsesBlob(request);
+	const header = [
+		...[
+			"// Cargo.toml: aws-config, aws-sdk-dynamodb, tokio (features = [\"full\"])",
+			"use aws_sdk_dynamodb::Client;",
+			...usesAv ? ["use aws_sdk_dynamodb::types::AttributeValue;"] : [],
+			...usesBlob ? ["use aws_sdk_dynamodb::primitives::Blob;"] : []
+		],
+		"",
+		"#[tokio::main]",
+		"async fn main() -> Result<(), aws_sdk_dynamodb::Error> {",
+		"    let config = aws_config::load_from_env().await;",
+		"    let client = Client::new(&config);",
+		""
+	];
+	const builder = renderRustBuilder(request, "        ");
+	if (!paginate) return [
+		...header,
+		"    let response = client",
+		...builder,
+		"        .send()",
+		"        .await?;",
+		"    println!(\"{:?}\", response.items());",
+		"",
+		"    Ok(())",
+		"}"
+	].join("\n");
+	return [
+		...header,
+		"    let mut items = client",
+		...builder,
+		"        .into_paginator()",
+		"        .items()",
+		"        .send();",
+		"",
+		"    while let Some(item) = items.next().await {",
+		"        println!(\"{:?}\", item?);",
+		"    }",
+		"",
+		"    Ok(())",
+		"}"
+	].join("\n");
+}
 function emitDotnetProgram(request, paginate) {
 	const method = dotnetClientMethodName(request.operation);
 	const binary = hasBinaryValue(request);
@@ -1868,4 +2036,4 @@ function emitDotnetProgram(request, paginate) {
 }
 
 //#endregion
-export { FILTER_OPERATORS, KEY_OPERATORS, OPERATOR_BY_VALUE, SET_TYPES, boto3MethodName, buildFilterExpressions, buildKeyConditionExpression, buildKeyMap, buildRequest, buildSdkV3Params, buildUpdateExpression, dotnetClientMethodName, dotnetRequestClassName, elementType, emitBoto3, emitCli, emitDdbToolboxProgram, emitDotnet, emitGo, emitJava, emitPartiql, emitQueryProgram, emitSdkV3, getCompatibleComparisonOperators, getCompatibleFilterOperators, goClientMethodName, goInputTypeName, hasBinaryValue, isSetType, javaClientMethodName, javaRequestClassName, makeTypedValue, renderJsValue, renderPyValue, sdkV3CommandName, typedMapToAvMap, typedValueToAv };
+export { FILTER_OPERATORS, KEY_OPERATORS, OPERATOR_BY_VALUE, SET_TYPES, boto3MethodName, buildFilterExpressions, buildKeyConditionExpression, buildKeyMap, buildRequest, buildSdkV3Params, buildUpdateExpression, dotnetClientMethodName, dotnetRequestClassName, elementType, emitBoto3, emitCli, emitDdbToolboxProgram, emitDotnet, emitGo, emitJava, emitPartiql, emitQueryProgram, emitRust, emitSdkV3, getCompatibleComparisonOperators, getCompatibleFilterOperators, goClientMethodName, goInputTypeName, hasBinaryValue, isSetType, javaClientMethodName, javaRequestClassName, makeTypedValue, renderJsValue, renderPyValue, renderRustAv, rustClientMethodName, sdkV3CommandName, typedMapToAvMap, typedValueToAv };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dynamodb-expression-builder",
-  "version": "0.1.1",
-  "description": "DynamoDB expression builder and code generator: build update, condition, filter and key condition expressions with automatic ExpressionAttributeNames/Values aliasing, then emit runnable code for the JavaScript SDK v3, AWS CLI, boto3, Java, Go, .NET, PartiQL and dynamodb-toolbox. Zero dependencies.",
+  "version": "0.2.0",
+  "description": "DynamoDB expression builder and code generator: build update, condition, filter and key condition expressions with automatic ExpressionAttributeNames/Values aliasing, then emit runnable code for the JavaScript SDK v3, AWS CLI, boto3, Java, Go, .NET, Rust, PartiQL and dynamodb-toolbox. Zero dependencies.",
   "keywords": [
     "dynamodb",
     "expression",
@@ -15,6 +15,7 @@
     "codegen",
     "query-builder",
     "boto3",
+    "rust",
     "aws"
   ],
   "license": "MIT",