anton-bakker-feedback 0.3.3 → 0.4.1
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/README.md +31 -0
- package/dist/chunks/{i18n-Du-or3T4.js → i18n-Cba0xHU-.js} +35 -1
- package/dist/chunks/i18n-Cba0xHU-.js.map +1 -0
- package/dist/core/index.d.ts +1 -0
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/ingest-transport.d.ts +53 -0
- package/dist/core/ingest-transport.d.ts.map +1 -0
- package/dist/core/locales/en.d.ts.map +1 -1
- package/dist/core/locales/nl.d.ts.map +1 -1
- package/dist/index.js +95 -1
- package/dist/index.js.map +1 -1
- package/dist/react.js +17 -17
- package/dist/react.js.map +1 -1
- package/dist/server/FeedbackService.d.ts +14 -0
- package/dist/server/FeedbackService.d.ts.map +1 -1
- package/dist/server.js +3 -0
- package/dist/server.js.map +1 -1
- package/package.json +1 -1
- package/dist/chunks/i18n-Du-or3T4.js.map +0 -1
|
@@ -9,6 +9,17 @@ export interface ListOptions {
|
|
|
9
9
|
limit?: number;
|
|
10
10
|
lastEvaluatedKey?: Record<string, unknown>;
|
|
11
11
|
}
|
|
12
|
+
/**
|
|
13
|
+
* FeedbackService — direct-DynamoDB CRUD for feedback items.
|
|
14
|
+
*
|
|
15
|
+
* @deprecated FOR WRITES (`put`): the central-storage principle requires feedback to be written
|
|
16
|
+
* through the authenticated central ingest API, not a bespoke direct-DynamoDB writer. Use
|
|
17
|
+
* `createIngestTransport(...)` (src/core/ingest-transport.ts) → `transport.submit(item)` so the
|
|
18
|
+
* consuming app holds a per-app JWT (no AWS principal) and the server stamps keys + enforces own-data.
|
|
19
|
+
* `put` is retained only for the server that owns the table during migration, and is removed once all
|
|
20
|
+
* writers are cut over to the ingest API. `get`/`list` remain valid server-side read operations until
|
|
21
|
+
* the ingest API grows its own authenticated read path.
|
|
22
|
+
*/
|
|
12
23
|
export declare class FeedbackService {
|
|
13
24
|
private readonly tableName;
|
|
14
25
|
private readonly region;
|
|
@@ -16,6 +27,9 @@ export declare class FeedbackService {
|
|
|
16
27
|
/**
|
|
17
28
|
* PutItem — writes a StoredFeedbackItem to DynamoDB.
|
|
18
29
|
* No-op when tableName is absent.
|
|
30
|
+
*
|
|
31
|
+
* @deprecated Direct-DynamoDB write — the pattern the central-storage principle removes. New
|
|
32
|
+
* writers use `createIngestTransport(...).submit(item)` (authenticated central ingest API).
|
|
19
33
|
*/
|
|
20
34
|
put(item: StoredFeedbackItem): Promise<void>;
|
|
21
35
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"FeedbackService.d.ts","sourceRoot":"","sources":["../../src/server/FeedbackService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAM3E,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AA4ED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,qBAAqB;IAOzC
|
|
1
|
+
{"version":3,"file":"FeedbackService.d.ts","sourceRoot":"","sources":["../../src/server/FeedbackService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAM3E,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AA4ED;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,qBAAqB;IAOzC;;;;;;OAMG;IACG,GAAG,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBlD;;;OAGG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA6BrE;;;OAGG;IACG,IAAI,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAmDlE"}
|
package/dist/server.js
CHANGED
|
@@ -68,6 +68,9 @@ class FeedbackService {
|
|
|
68
68
|
/**
|
|
69
69
|
* PutItem — writes a StoredFeedbackItem to DynamoDB.
|
|
70
70
|
* No-op when tableName is absent.
|
|
71
|
+
*
|
|
72
|
+
* @deprecated Direct-DynamoDB write — the pattern the central-storage principle removes. New
|
|
73
|
+
* writers use `createIngestTransport(...).submit(item)` (authenticated central ingest API).
|
|
71
74
|
*/
|
|
72
75
|
async put(item) {
|
|
73
76
|
if (!this.tableName) {
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sources":["../src/server/FeedbackService.ts","../src/server/listHandler.ts"],"sourcesContent":["/**\n * FeedbackService — DynamoDB CRUD operations for feedback items.\n *\n * Server-only module — NOT imported by the client bundle.\n * Uses dynamic import for @aws-sdk/client-dynamodb to avoid hard client bundle dep\n * (same pattern as submitResolver.ts).\n *\n * When tableName is absent (Minimal level), put is a no-op and list returns [].\n */\n\nimport type { StoredFeedbackItem, FeedbackStatus } from '../core/types.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Config\n// ─────────────────────────────────────────────────────────────────\n\nexport interface FeedbackServiceConfig {\n tableName: string;\n region: string;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// ListOptions\n// ─────────────────────────────────────────────────────────────────\n\nexport interface ListOptions {\n status?: FeedbackStatus;\n limit?: number;\n lastEvaluatedKey?: Record<string, unknown>;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Helpers\n// ─────────────────────────────────────────────────────────────────\n\n/** Marshal a JS value to a DynamoDB AttributeValue */\nfunction toAttr(value: unknown): Record<string, unknown> {\n if (value === null || value === undefined) {\n return { NULL: true };\n }\n if (typeof value === 'string') {\n return { S: value };\n }\n if (typeof value === 'number') {\n return { N: String(value) };\n }\n if (typeof value === 'boolean') {\n return { BOOL: value };\n }\n if (Array.isArray(value)) {\n return { L: value.map(toAttr) };\n }\n if (typeof value === 'object') {\n const m: Record<string, Record<string, unknown>> = {};\n for (const [k, v] of Object.entries(value as Record<string, unknown>)) {\n m[k] = toAttr(v);\n }\n return { M: m };\n }\n return { S: String(value) };\n}\n\n/** Marshal the entire StoredFeedbackItem to a DynamoDB Item map */\nfunction marshalItem(item: StoredFeedbackItem): Record<string, Record<string, unknown>> {\n const result: Record<string, Record<string, unknown>> = {};\n for (const [key, value] of Object.entries(item as unknown as Record<string, unknown>)) {\n if (value !== undefined) {\n result[key] = toAttr(value);\n }\n }\n return result;\n}\n\n/** Unmarshal a DynamoDB AttributeValue to a JS value */\nfunction fromAttr(attr: Record<string, unknown>): unknown {\n if (attr['S'] !== undefined) return attr['S'];\n if (attr['N'] !== undefined) return Number(attr['N']);\n if (attr['BOOL'] !== undefined) return attr['BOOL'];\n if (attr['NULL']) return null;\n if (attr['L']) {\n return (attr['L'] as Array<Record<string, unknown>>).map(fromAttr);\n }\n if (attr['M']) {\n const obj: Record<string, unknown> = {};\n for (const [k, v] of Object.entries(attr['M'] as Record<string, Record<string, unknown>>)) {\n obj[k] = fromAttr(v);\n }\n return obj;\n }\n return undefined;\n}\n\n/** Unmarshal a DynamoDB Item map to StoredFeedbackItem */\nfunction unmarshalItem(item: Record<string, Record<string, unknown>>): StoredFeedbackItem {\n const result: Record<string, unknown> = {};\n for (const [key, attr] of Object.entries(item)) {\n result[key] = fromAttr(attr);\n }\n return result as unknown as StoredFeedbackItem;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// FeedbackService\n// ─────────────────────────────────────────────────────────────────\n\nexport class FeedbackService {\n private readonly tableName: string;\n private readonly region: string;\n\n constructor(config: FeedbackServiceConfig) {\n this.tableName = config.tableName;\n this.region = config.region;\n }\n\n // ── put ────────────────────────────────────────────────────────\n\n /**\n * PutItem — writes a StoredFeedbackItem to DynamoDB.\n * No-op when tableName is absent.\n */\n async put(item: StoredFeedbackItem): Promise<void> {\n if (!this.tableName) {\n return;\n }\n\n // Dynamic import to avoid hard dependency on AWS SDK in client bundle\n const dynamoPrefix = ['@aws', '-sdk/client-dynamo', 'db'].join('');\n const { DynamoDBClient, PutItemCommand } = await import(/* @vite-ignore */ dynamoPrefix);\n\n const client = new DynamoDBClient({ region: this.region });\n\n await client.send(\n new PutItemCommand({\n TableName: this.tableName,\n Item: marshalItem(item),\n }),\n );\n }\n\n // ── get ────────────────────────────────────────────────────────\n\n /**\n * GetItem — retrieves a StoredFeedbackItem by PK+SK.\n * Returns null if the item does not exist.\n */\n async get(pk: string, sk: string): Promise<StoredFeedbackItem | null> {\n if (!this.tableName) {\n return null;\n }\n\n const dynamoPrefix = ['@aws', '-sdk/client-dynamo', 'db'].join('');\n const { DynamoDBClient, GetItemCommand } = await import(/* @vite-ignore */ dynamoPrefix);\n\n const client = new DynamoDBClient({ region: this.region });\n\n const response = await client.send(\n new GetItemCommand({\n TableName: this.tableName,\n Key: {\n PK: { S: pk },\n SK: { S: sk },\n },\n }),\n );\n\n if (!response.Item) {\n return null;\n }\n\n return unmarshalItem(response.Item as Record<string, Record<string, unknown>>);\n }\n\n // ── list ───────────────────────────────────────────────────────\n\n /**\n * Query GSI1 with optional status filter.\n * Returns [] when tableName is absent (Minimal level).\n */\n async list(opts: ListOptions = {}): Promise<StoredFeedbackItem[]> {\n if (!this.tableName) {\n return [];\n }\n\n const dynamoPrefix = ['@aws', '-sdk/client-dynamo', 'db'].join('');\n const { DynamoDBClient, QueryCommand } = await import(/* @vite-ignore */ dynamoPrefix);\n\n const client = new DynamoDBClient({ region: this.region });\n\n const limit = opts.limit ?? 50;\n const gsi1pk = opts.status ? `STATUS#${opts.status}` : undefined;\n\n // Build query params\n type QueryParams = {\n TableName: string;\n IndexName: string;\n KeyConditionExpression: string;\n ExpressionAttributeNames: Record<string, string>;\n ExpressionAttributeValues: Record<string, Record<string, unknown>>;\n Limit: number;\n ExclusiveStartKey?: Record<string, unknown>;\n ScanIndexForward: boolean;\n };\n\n const params: QueryParams = {\n TableName: this.tableName,\n IndexName: 'GSI1',\n KeyConditionExpression: '#pk = :pk',\n ExpressionAttributeNames: {\n '#pk': 'GSI1PK',\n },\n ExpressionAttributeValues: {\n ':pk': { S: gsi1pk ?? 'STATUS#open' },\n },\n Limit: limit,\n ScanIndexForward: false, // Descending (highest priority first via inverted sort key)\n };\n\n if (opts.lastEvaluatedKey) {\n params.ExclusiveStartKey = opts.lastEvaluatedKey;\n }\n\n const response = await client.send(new QueryCommand(params));\n\n if (!response.Items || response.Items.length === 0) {\n return [];\n }\n\n return (response.Items as Array<Record<string, Record<string, unknown>>>).map(unmarshalItem);\n }\n}\n","/**\n * listHandler — HTTP GET /api/feedback/list handler factory.\n *\n * Server-only module — NOT imported by the client bundle.\n *\n * HTTP contract:\n * GET /api/feedback/list\n * Query params: ?status=open&limit=20\n * → 200 { items: StoredFeedbackItem[]; nextKey?: string }\n * → 400 { errors: string[] }\n */\n\nimport type { FeedbackStatus, StoredFeedbackItem } from '../core/types.js';\nimport { FeedbackService } from './FeedbackService.js';\nimport type { ListOptions } from './FeedbackService.js';\nimport type { RequestHandler } from '../react/resolver/submitResolver.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Config\n// ─────────────────────────────────────────────────────────────────\n\nexport interface ListHandlerConfig {\n /** DynamoDB table name — if absent, returns [] (Minimal level) */\n tableName?: string;\n /** AWS region for DynamoDB */\n region?: string;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Valid status values\n// ─────────────────────────────────────────────────────────────────\n\nconst VALID_STATUSES: FeedbackStatus[] = ['open', 'approved', 'deferred', 'resolved', 'wontfix'];\n\n// ─────────────────────────────────────────────────────────────────\n// Handler Factory\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Creates an Express/Lambda-compatible request handler for the list endpoint.\n *\n * Validates query params → queries DynamoDB GSI1 → returns paginated results.\n * Returns 400 for invalid status values.\n * Returns 200 with items array (empty [] when no tableName configured).\n */\nexport function createListHandler(config: ListHandlerConfig): RequestHandler {\n const service = new FeedbackService({\n tableName: config.tableName ?? '',\n region: config.region ?? 'us-east-1',\n });\n\n return async (req, res) => {\n const errors: string[] = [];\n\n // Extract query params from URL or req.body (depending on framework shape)\n // We parse from the req — in Express, query params live in req.query\n // but our RequestBody interface doesn't define query. Parse from body if present.\n const query = (req as unknown as { query?: Record<string, string> }).query ?? {};\n const rawStatus = query['status'];\n const rawLimit = query['limit'];\n\n // Validate status\n let status: FeedbackStatus | undefined;\n if (rawStatus !== undefined) {\n if (!VALID_STATUSES.includes(rawStatus as FeedbackStatus)) {\n errors.push(`status must be one of: ${VALID_STATUSES.join(', ')} (got: ${rawStatus})`);\n } else {\n status = rawStatus as FeedbackStatus;\n }\n }\n\n // Validate limit\n let limit: number | undefined;\n if (rawLimit !== undefined) {\n const parsed = parseInt(rawLimit, 10);\n if (isNaN(parsed) || parsed < 1 || parsed > 100) {\n errors.push('limit must be a number between 1 and 100');\n } else {\n limit = parsed;\n }\n }\n\n if (errors.length > 0) {\n res.status(400).json({ errors });\n return;\n }\n\n const opts: ListOptions = {};\n if (status !== undefined) opts.status = status;\n if (limit !== undefined) opts.limit = limit;\n\n const items: StoredFeedbackItem[] = await service.list(opts);\n\n res.status(200).json({ items });\n };\n}\n"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"server.js","sources":["../src/server/FeedbackService.ts","../src/server/listHandler.ts"],"sourcesContent":["/**\n * FeedbackService — DynamoDB CRUD operations for feedback items.\n *\n * Server-only module — NOT imported by the client bundle.\n * Uses dynamic import for @aws-sdk/client-dynamodb to avoid hard client bundle dep\n * (same pattern as submitResolver.ts).\n *\n * When tableName is absent (Minimal level), put is a no-op and list returns [].\n */\n\nimport type { StoredFeedbackItem, FeedbackStatus } from '../core/types.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Config\n// ─────────────────────────────────────────────────────────────────\n\nexport interface FeedbackServiceConfig {\n tableName: string;\n region: string;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// ListOptions\n// ─────────────────────────────────────────────────────────────────\n\nexport interface ListOptions {\n status?: FeedbackStatus;\n limit?: number;\n lastEvaluatedKey?: Record<string, unknown>;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Helpers\n// ─────────────────────────────────────────────────────────────────\n\n/** Marshal a JS value to a DynamoDB AttributeValue */\nfunction toAttr(value: unknown): Record<string, unknown> {\n if (value === null || value === undefined) {\n return { NULL: true };\n }\n if (typeof value === 'string') {\n return { S: value };\n }\n if (typeof value === 'number') {\n return { N: String(value) };\n }\n if (typeof value === 'boolean') {\n return { BOOL: value };\n }\n if (Array.isArray(value)) {\n return { L: value.map(toAttr) };\n }\n if (typeof value === 'object') {\n const m: Record<string, Record<string, unknown>> = {};\n for (const [k, v] of Object.entries(value as Record<string, unknown>)) {\n m[k] = toAttr(v);\n }\n return { M: m };\n }\n return { S: String(value) };\n}\n\n/** Marshal the entire StoredFeedbackItem to a DynamoDB Item map */\nfunction marshalItem(item: StoredFeedbackItem): Record<string, Record<string, unknown>> {\n const result: Record<string, Record<string, unknown>> = {};\n for (const [key, value] of Object.entries(item as unknown as Record<string, unknown>)) {\n if (value !== undefined) {\n result[key] = toAttr(value);\n }\n }\n return result;\n}\n\n/** Unmarshal a DynamoDB AttributeValue to a JS value */\nfunction fromAttr(attr: Record<string, unknown>): unknown {\n if (attr['S'] !== undefined) return attr['S'];\n if (attr['N'] !== undefined) return Number(attr['N']);\n if (attr['BOOL'] !== undefined) return attr['BOOL'];\n if (attr['NULL']) return null;\n if (attr['L']) {\n return (attr['L'] as Array<Record<string, unknown>>).map(fromAttr);\n }\n if (attr['M']) {\n const obj: Record<string, unknown> = {};\n for (const [k, v] of Object.entries(attr['M'] as Record<string, Record<string, unknown>>)) {\n obj[k] = fromAttr(v);\n }\n return obj;\n }\n return undefined;\n}\n\n/** Unmarshal a DynamoDB Item map to StoredFeedbackItem */\nfunction unmarshalItem(item: Record<string, Record<string, unknown>>): StoredFeedbackItem {\n const result: Record<string, unknown> = {};\n for (const [key, attr] of Object.entries(item)) {\n result[key] = fromAttr(attr);\n }\n return result as unknown as StoredFeedbackItem;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// FeedbackService\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * FeedbackService — direct-DynamoDB CRUD for feedback items.\n *\n * @deprecated FOR WRITES (`put`): the central-storage principle requires feedback to be written\n * through the authenticated central ingest API, not a bespoke direct-DynamoDB writer. Use\n * `createIngestTransport(...)` (src/core/ingest-transport.ts) → `transport.submit(item)` so the\n * consuming app holds a per-app JWT (no AWS principal) and the server stamps keys + enforces own-data.\n * `put` is retained only for the server that owns the table during migration, and is removed once all\n * writers are cut over to the ingest API. `get`/`list` remain valid server-side read operations until\n * the ingest API grows its own authenticated read path.\n */\nexport class FeedbackService {\n private readonly tableName: string;\n private readonly region: string;\n\n constructor(config: FeedbackServiceConfig) {\n this.tableName = config.tableName;\n this.region = config.region;\n }\n\n // ── put ────────────────────────────────────────────────────────\n\n /**\n * PutItem — writes a StoredFeedbackItem to DynamoDB.\n * No-op when tableName is absent.\n *\n * @deprecated Direct-DynamoDB write — the pattern the central-storage principle removes. New\n * writers use `createIngestTransport(...).submit(item)` (authenticated central ingest API).\n */\n async put(item: StoredFeedbackItem): Promise<void> {\n if (!this.tableName) {\n return;\n }\n\n // Dynamic import to avoid hard dependency on AWS SDK in client bundle\n const dynamoPrefix = ['@aws', '-sdk/client-dynamo', 'db'].join('');\n const { DynamoDBClient, PutItemCommand } = await import(/* @vite-ignore */ dynamoPrefix);\n\n const client = new DynamoDBClient({ region: this.region });\n\n await client.send(\n new PutItemCommand({\n TableName: this.tableName,\n Item: marshalItem(item),\n }),\n );\n }\n\n // ── get ────────────────────────────────────────────────────────\n\n /**\n * GetItem — retrieves a StoredFeedbackItem by PK+SK.\n * Returns null if the item does not exist.\n */\n async get(pk: string, sk: string): Promise<StoredFeedbackItem | null> {\n if (!this.tableName) {\n return null;\n }\n\n const dynamoPrefix = ['@aws', '-sdk/client-dynamo', 'db'].join('');\n const { DynamoDBClient, GetItemCommand } = await import(/* @vite-ignore */ dynamoPrefix);\n\n const client = new DynamoDBClient({ region: this.region });\n\n const response = await client.send(\n new GetItemCommand({\n TableName: this.tableName,\n Key: {\n PK: { S: pk },\n SK: { S: sk },\n },\n }),\n );\n\n if (!response.Item) {\n return null;\n }\n\n return unmarshalItem(response.Item as Record<string, Record<string, unknown>>);\n }\n\n // ── list ───────────────────────────────────────────────────────\n\n /**\n * Query GSI1 with optional status filter.\n * Returns [] when tableName is absent (Minimal level).\n */\n async list(opts: ListOptions = {}): Promise<StoredFeedbackItem[]> {\n if (!this.tableName) {\n return [];\n }\n\n const dynamoPrefix = ['@aws', '-sdk/client-dynamo', 'db'].join('');\n const { DynamoDBClient, QueryCommand } = await import(/* @vite-ignore */ dynamoPrefix);\n\n const client = new DynamoDBClient({ region: this.region });\n\n const limit = opts.limit ?? 50;\n const gsi1pk = opts.status ? `STATUS#${opts.status}` : undefined;\n\n // Build query params\n type QueryParams = {\n TableName: string;\n IndexName: string;\n KeyConditionExpression: string;\n ExpressionAttributeNames: Record<string, string>;\n ExpressionAttributeValues: Record<string, Record<string, unknown>>;\n Limit: number;\n ExclusiveStartKey?: Record<string, unknown>;\n ScanIndexForward: boolean;\n };\n\n const params: QueryParams = {\n TableName: this.tableName,\n IndexName: 'GSI1',\n KeyConditionExpression: '#pk = :pk',\n ExpressionAttributeNames: {\n '#pk': 'GSI1PK',\n },\n ExpressionAttributeValues: {\n ':pk': { S: gsi1pk ?? 'STATUS#open' },\n },\n Limit: limit,\n ScanIndexForward: false, // Descending (highest priority first via inverted sort key)\n };\n\n if (opts.lastEvaluatedKey) {\n params.ExclusiveStartKey = opts.lastEvaluatedKey;\n }\n\n const response = await client.send(new QueryCommand(params));\n\n if (!response.Items || response.Items.length === 0) {\n return [];\n }\n\n return (response.Items as Array<Record<string, Record<string, unknown>>>).map(unmarshalItem);\n }\n}\n","/**\n * listHandler — HTTP GET /api/feedback/list handler factory.\n *\n * Server-only module — NOT imported by the client bundle.\n *\n * HTTP contract:\n * GET /api/feedback/list\n * Query params: ?status=open&limit=20\n * → 200 { items: StoredFeedbackItem[]; nextKey?: string }\n * → 400 { errors: string[] }\n */\n\nimport type { FeedbackStatus, StoredFeedbackItem } from '../core/types.js';\nimport { FeedbackService } from './FeedbackService.js';\nimport type { ListOptions } from './FeedbackService.js';\nimport type { RequestHandler } from '../react/resolver/submitResolver.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Config\n// ─────────────────────────────────────────────────────────────────\n\nexport interface ListHandlerConfig {\n /** DynamoDB table name — if absent, returns [] (Minimal level) */\n tableName?: string;\n /** AWS region for DynamoDB */\n region?: string;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Valid status values\n// ─────────────────────────────────────────────────────────────────\n\nconst VALID_STATUSES: FeedbackStatus[] = ['open', 'approved', 'deferred', 'resolved', 'wontfix'];\n\n// ─────────────────────────────────────────────────────────────────\n// Handler Factory\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Creates an Express/Lambda-compatible request handler for the list endpoint.\n *\n * Validates query params → queries DynamoDB GSI1 → returns paginated results.\n * Returns 400 for invalid status values.\n * Returns 200 with items array (empty [] when no tableName configured).\n */\nexport function createListHandler(config: ListHandlerConfig): RequestHandler {\n const service = new FeedbackService({\n tableName: config.tableName ?? '',\n region: config.region ?? 'us-east-1',\n });\n\n return async (req, res) => {\n const errors: string[] = [];\n\n // Extract query params from URL or req.body (depending on framework shape)\n // We parse from the req — in Express, query params live in req.query\n // but our RequestBody interface doesn't define query. Parse from body if present.\n const query = (req as unknown as { query?: Record<string, string> }).query ?? {};\n const rawStatus = query['status'];\n const rawLimit = query['limit'];\n\n // Validate status\n let status: FeedbackStatus | undefined;\n if (rawStatus !== undefined) {\n if (!VALID_STATUSES.includes(rawStatus as FeedbackStatus)) {\n errors.push(`status must be one of: ${VALID_STATUSES.join(', ')} (got: ${rawStatus})`);\n } else {\n status = rawStatus as FeedbackStatus;\n }\n }\n\n // Validate limit\n let limit: number | undefined;\n if (rawLimit !== undefined) {\n const parsed = parseInt(rawLimit, 10);\n if (isNaN(parsed) || parsed < 1 || parsed > 100) {\n errors.push('limit must be a number between 1 and 100');\n } else {\n limit = parsed;\n }\n }\n\n if (errors.length > 0) {\n res.status(400).json({ errors });\n return;\n }\n\n const opts: ListOptions = {};\n if (status !== undefined) opts.status = status;\n if (limit !== undefined) opts.limit = limit;\n\n const items: StoredFeedbackItem[] = await service.list(opts);\n\n res.status(200).json({ items });\n };\n}\n"],"names":[],"mappings":";AAoCA,SAAS,OAAO,OAAyC;AACvD,MAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,WAAO,EAAE,MAAM,KAAA;AAAA,EACjB;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,GAAG,MAAA;AAAA,EACd;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,GAAG,OAAO,KAAK,EAAA;AAAA,EAC1B;AACA,MAAI,OAAO,UAAU,WAAW;AAC9B,WAAO,EAAE,MAAM,MAAA;AAAA,EACjB;AACA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,EAAE,GAAG,MAAM,IAAI,MAAM,EAAA;AAAA,EAC9B;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,IAA6C,CAAA;AACnD,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,KAAgC,GAAG;AACrE,QAAE,CAAC,IAAI,OAAO,CAAC;AAAA,IACjB;AACA,WAAO,EAAE,GAAG,EAAA;AAAA,EACd;AACA,SAAO,EAAE,GAAG,OAAO,KAAK,EAAA;AAC1B;AAGA,SAAS,YAAY,MAAmE;AACtF,QAAM,SAAkD,CAAA;AACxD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAA0C,GAAG;AACrF,QAAI,UAAU,QAAW;AACvB,aAAO,GAAG,IAAI,OAAO,KAAK;AAAA,IAC5B;AAAA,EACF;AACA,SAAO;AACT;AAGA,SAAS,SAAS,MAAwC;AACxD,MAAI,KAAK,GAAG,MAAM,OAAW,QAAO,KAAK,GAAG;AAC5C,MAAI,KAAK,GAAG,MAAM,eAAkB,OAAO,KAAK,GAAG,CAAC;AACpD,MAAI,KAAK,MAAM,MAAM,OAAW,QAAO,KAAK,MAAM;AAClD,MAAI,KAAK,MAAM,EAAG,QAAO;AACzB,MAAI,KAAK,GAAG,GAAG;AACb,WAAQ,KAAK,GAAG,EAAqC,IAAI,QAAQ;AAAA,EACnE;AACA,MAAI,KAAK,GAAG,GAAG;AACb,UAAM,MAA+B,CAAA;AACrC,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,KAAK,GAAG,CAA4C,GAAG;AACzF,UAAI,CAAC,IAAI,SAAS,CAAC;AAAA,IACrB;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAGA,SAAS,cAAc,MAAmE;AACxF,QAAM,SAAkC,CAAA;AACxC,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC9C,WAAO,GAAG,IAAI,SAAS,IAAI;AAAA,EAC7B;AACA,SAAO;AACT;AAiBO,MAAM,gBAAgB;AAAA,EACV;AAAA,EACA;AAAA,EAEjB,YAAY,QAA+B;AACzC,SAAK,YAAY,OAAO;AACxB,SAAK,SAAS,OAAO;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,IAAI,MAAyC;AACjD,QAAI,CAAC,KAAK,WAAW;AACnB;AAAA,IACF;AAGA,UAAM,eAAe,CAAC,QAAQ,sBAAsB,IAAI,EAAE,KAAK,EAAE;AACjE,UAAM,EAAE,gBAAgB,eAAA,IAAmB,MAAM;AAAA;AAAA,MAA0B;AAAA;AAE3E,UAAM,SAAS,IAAI,eAAe,EAAE,QAAQ,KAAK,QAAQ;AAEzD,UAAM,OAAO;AAAA,MACX,IAAI,eAAe;AAAA,QACjB,WAAW,KAAK;AAAA,QAChB,MAAM,YAAY,IAAI;AAAA,MAAA,CACvB;AAAA,IAAA;AAAA,EAEL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,IAAgD;AACpE,QAAI,CAAC,KAAK,WAAW;AACnB,aAAO;AAAA,IACT;AAEA,UAAM,eAAe,CAAC,QAAQ,sBAAsB,IAAI,EAAE,KAAK,EAAE;AACjE,UAAM,EAAE,gBAAgB,eAAA,IAAmB,MAAM;AAAA;AAAA,MAA0B;AAAA;AAE3E,UAAM,SAAS,IAAI,eAAe,EAAE,QAAQ,KAAK,QAAQ;AAEzD,UAAM,WAAW,MAAM,OAAO;AAAA,MAC5B,IAAI,eAAe;AAAA,QACjB,WAAW,KAAK;AAAA,QAChB,KAAK;AAAA,UACH,IAAI,EAAE,GAAG,GAAA;AAAA,UACT,IAAI,EAAE,GAAG,GAAA;AAAA,QAAG;AAAA,MACd,CACD;AAAA,IAAA;AAGH,QAAI,CAAC,SAAS,MAAM;AAClB,aAAO;AAAA,IACT;AAEA,WAAO,cAAc,SAAS,IAA+C;AAAA,EAC/E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,KAAK,OAAoB,IAAmC;AAChE,QAAI,CAAC,KAAK,WAAW;AACnB,aAAO,CAAA;AAAA,IACT;AAEA,UAAM,eAAe,CAAC,QAAQ,sBAAsB,IAAI,EAAE,KAAK,EAAE;AACjE,UAAM,EAAE,gBAAgB,aAAA,IAAiB,MAAM;AAAA;AAAA,MAA0B;AAAA;AAEzE,UAAM,SAAS,IAAI,eAAe,EAAE,QAAQ,KAAK,QAAQ;AAEzD,UAAM,QAAQ,KAAK,SAAS;AAC5B,UAAM,SAAS,KAAK,SAAS,UAAU,KAAK,MAAM,KAAK;AAcvD,UAAM,SAAsB;AAAA,MAC1B,WAAW,KAAK;AAAA,MAChB,WAAW;AAAA,MACX,wBAAwB;AAAA,MACxB,0BAA0B;AAAA,QACxB,OAAO;AAAA,MAAA;AAAA,MAET,2BAA2B;AAAA,QACzB,OAAO,EAAE,GAAG,UAAU,cAAA;AAAA,MAAc;AAAA,MAEtC,OAAO;AAAA,MACP,kBAAkB;AAAA;AAAA,IAAA;AAGpB,QAAI,KAAK,kBAAkB;AACzB,aAAO,oBAAoB,KAAK;AAAA,IAClC;AAEA,UAAM,WAAW,MAAM,OAAO,KAAK,IAAI,aAAa,MAAM,CAAC;AAE3D,QAAI,CAAC,SAAS,SAAS,SAAS,MAAM,WAAW,GAAG;AAClD,aAAO,CAAA;AAAA,IACT;AAEA,WAAQ,SAAS,MAAyD,IAAI,aAAa;AAAA,EAC7F;AACF;ACnNA,MAAM,iBAAmC,CAAC,QAAQ,YAAY,YAAY,YAAY,SAAS;AAaxF,SAAS,kBAAkB,QAA2C;AAC3E,QAAM,UAAU,IAAI,gBAAgB;AAAA,IAClC,WAAW,OAAO,aAAa;AAAA,IAC/B,QAAQ,OAAO,UAAU;AAAA,EAAA,CAC1B;AAED,SAAO,OAAO,KAAK,QAAQ;AACzB,UAAM,SAAmB,CAAA;AAKzB,UAAM,QAAS,IAAsD,SAAS,CAAA;AAC9E,UAAM,YAAY,MAAM,QAAQ;AAChC,UAAM,WAAW,MAAM,OAAO;AAG9B,QAAI;AACJ,QAAI,cAAc,QAAW;AAC3B,UAAI,CAAC,eAAe,SAAS,SAA2B,GAAG;AACzD,eAAO,KAAK,0BAA0B,eAAe,KAAK,IAAI,CAAC,UAAU,SAAS,GAAG;AAAA,MACvF,OAAO;AACL,iBAAS;AAAA,MACX;AAAA,IACF;AAGA,QAAI;AACJ,QAAI,aAAa,QAAW;AAC1B,YAAM,SAAS,SAAS,UAAU,EAAE;AACpC,UAAI,MAAM,MAAM,KAAK,SAAS,KAAK,SAAS,KAAK;AAC/C,eAAO,KAAK,0CAA0C;AAAA,MACxD,OAAO;AACL,gBAAQ;AAAA,MACV;AAAA,IACF;AAEA,QAAI,OAAO,SAAS,GAAG;AACrB,UAAI,OAAO,GAAG,EAAE,KAAK,EAAE,QAAQ;AAC/B;AAAA,IACF;AAEA,UAAM,OAAoB,CAAA;AAC1B,QAAI,WAAW,OAAW,MAAK,SAAS;AACxC,QAAI,UAAU,OAAW,MAAK,QAAQ;AAEtC,UAAM,QAA8B,MAAM,QAAQ,KAAK,IAAI;AAE3D,QAAI,OAAO,GAAG,EAAE,KAAK,EAAE,OAAO;AAAA,EAChC;AACF;"}
|
package/package.json
CHANGED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"i18n-Du-or3T4.js","sources":["../../src/core/config.ts","../../src/core/locales/en.ts","../../src/core/locales/nl.ts","../../src/core/i18n.ts"],"sourcesContent":["/**\n * Configuration schema and validation for the anton-bakker-feedback package.\n */\n\nimport type { FeedbackEnvironment } from './types.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Config Interface\n// ─────────────────────────────────────────────────────────────────\n\n/** Full configuration object for the feedback package */\nexport interface FeedbackConfig {\n /** Required — alphanumeric, hyphens, underscores only */\n appName: string;\n version?: string;\n /** Defaults to 'production' if absent */\n environment?: FeedbackEnvironment;\n\n transport: {\n /** POST endpoint — app provides its own route */\n submitUrl: string;\n /** If absent → dialogue disabled, form shown */\n dialogueUrl?: string;\n /** If absent → screenshots disabled */\n screenshotUploadUrl?: string;\n };\n\n dialogue?: {\n /** Default 3; min 1, max 10 */\n maxTurns?: number;\n /** Default 30_000 */\n timeoutMs?: number;\n };\n\n screenshots?: {\n /** Default true if screenshotUploadUrl set */\n enabled?: boolean;\n /** Default 5_242_880 (5 MB) */\n maxSizeBytes?: number;\n };\n\n ui?: {\n /** Default 'bottom-right' */\n position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';\n /** Default 'auto' */\n theme?: 'light' | 'dark' | 'auto';\n };\n\n observability?: {\n /** Default true */\n enabled?: boolean;\n /** Default 'Feedback/Service' */\n namespace?: string;\n /** Default ['x-trace-id', 'x-request-id'] */\n traceIdHeaders?: string[];\n };\n\n i18n?: {\n /** Default 'en' */\n locale?: string;\n customTranslations?: Record<string, Record<string, string>>;\n };\n\n signOff?: {\n /** Default 7; 0 = manual only */\n autoConfirmDays?: number;\n /** Default 3 */\n reminderDays?: number;\n };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Resolved Config — all fields have values, no undefined\n// ─────────────────────────────────────────────────────────────────\n\n/** Fully-resolved config with all defaults applied — no undefined fields */\nexport interface ResolvedFeedbackConfig {\n appName: string;\n version: string;\n environment: FeedbackEnvironment;\n\n transport: {\n submitUrl: string;\n dialogueUrl: string | undefined;\n screenshotUploadUrl: string | undefined;\n };\n\n dialogue: {\n maxTurns: number;\n timeoutMs: number;\n };\n\n screenshots: {\n enabled: boolean;\n maxSizeBytes: number;\n };\n\n ui: {\n position: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';\n theme: 'light' | 'dark' | 'auto';\n };\n\n observability: {\n enabled: boolean;\n namespace: string;\n traceIdHeaders: string[];\n };\n\n i18n: {\n locale: string;\n customTranslations: Record<string, Record<string, string>>;\n };\n\n signOff: {\n autoConfirmDays: number;\n reminderDays: number;\n };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Validation\n// ─────────────────────────────────────────────────────────────────\n\nconst APP_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;\nconst URL_PATTERN = /^https?:\\/\\/.+/;\n\n/** Validation result with structured errors */\nexport interface ConfigValidationResult {\n valid: boolean;\n errors: string[];\n}\n\n/**\n * Validates a FeedbackConfig and returns structured errors.\n * Returns { valid: false, errors: [...] } with actionable messages.\n */\nexport function validateConfig(config: Partial<FeedbackConfig>): ConfigValidationResult {\n const errors: string[] = [];\n\n // Validate appName\n if (!config.appName || config.appName.trim() === '') {\n errors.push('appName is required and must not be empty');\n } else if (!APP_NAME_PATTERN.test(config.appName)) {\n errors.push(\n `appName \"${config.appName}\" is invalid — must match /^[a-zA-Z0-9_-]+$/ (no spaces, slashes, or special characters)`,\n );\n }\n\n // Validate transport.submitUrl\n if (!config.transport?.submitUrl || config.transport.submitUrl.trim() === '') {\n errors.push('transport.submitUrl is required and must not be empty');\n } else if (!URL_PATTERN.test(config.transport.submitUrl)) {\n errors.push(\n `transport.submitUrl \"${config.transport.submitUrl}\" must be a valid URL starting with http:// or https://`,\n );\n }\n\n // Validate dialogue.maxTurns\n if (config.dialogue?.maxTurns !== undefined) {\n const turns = config.dialogue.maxTurns;\n if (!Number.isInteger(turns) || turns < 1 || turns > 10) {\n errors.push(\n `dialogue.maxTurns must be an integer between 1 and 10 (got ${turns})`,\n );\n }\n }\n\n // Validate screenshots.maxSizeBytes\n if (config.screenshots?.maxSizeBytes !== undefined) {\n const size = config.screenshots.maxSizeBytes;\n if (!Number.isFinite(size) || size <= 0) {\n errors.push(`screenshots.maxSizeBytes must be a positive number (got ${size})`);\n }\n }\n\n return {\n valid: errors.length === 0,\n errors,\n };\n}\n\n/**\n * Merges user-supplied partial config with defaults.\n * Returns a fully-resolved config with no undefined fields.\n */\nexport function resolveConfig(config: FeedbackConfig): ResolvedFeedbackConfig {\n const screenshotsEnabled =\n config.screenshots?.enabled !== undefined\n ? config.screenshots.enabled\n : !!config.transport.screenshotUploadUrl;\n\n return {\n appName: config.appName,\n version: config.version ?? '0.0.0',\n environment: config.environment ?? 'production',\n\n transport: {\n submitUrl: config.transport.submitUrl,\n dialogueUrl: config.transport.dialogueUrl,\n screenshotUploadUrl: config.transport.screenshotUploadUrl,\n },\n\n dialogue: {\n maxTurns: config.dialogue?.maxTurns ?? 3,\n timeoutMs: config.dialogue?.timeoutMs ?? 30_000,\n },\n\n screenshots: {\n enabled: screenshotsEnabled,\n maxSizeBytes: config.screenshots?.maxSizeBytes ?? 5_242_880,\n },\n\n ui: {\n position: config.ui?.position ?? 'bottom-right',\n theme: config.ui?.theme ?? 'auto',\n },\n\n observability: {\n enabled: config.observability?.enabled ?? true,\n namespace: config.observability?.namespace ?? 'Feedback/Service',\n traceIdHeaders: config.observability?.traceIdHeaders ?? [\n 'x-trace-id',\n 'x-request-id',\n ],\n },\n\n i18n: {\n locale: config.i18n?.locale ?? 'en',\n customTranslations: config.i18n?.customTranslations ?? {},\n },\n\n signOff: {\n autoConfirmDays: config.signOff?.autoConfirmDays ?? 7,\n reminderDays: config.signOff?.reminderDays ?? 3,\n },\n };\n}\n","/**\n * English (en) translations for the feedback package.\n * Key format: feedback.{component}.{element}\n */\nexport const en: Record<string, string> = {\n // Button labels\n 'feedback.button.open': 'Feedback',\n 'feedback.button.close': 'Close',\n 'feedback.button.screenshot': 'Add screenshot',\n 'feedback.button.removeScreenshot': 'Remove screenshot',\n 'feedback.button.submit': 'Submit feedback',\n\n // Form labels\n 'feedback.form.contentLabel': 'What would you like to share?',\n 'feedback.form.contentPlaceholder': 'Describe the issue or suggestion in detail...',\n 'feedback.form.typeLabel': 'Type',\n 'feedback.form.typePlaceholder': 'Select a type',\n\n // Dialogue states\n 'feedback.dialogue.opening': 'Thank you for your feedback. I have a few questions to help us understand better.',\n 'feedback.dialogue.thinking': 'Thinking...',\n 'feedback.dialogue.error': 'Sorry, something went wrong. Please try again.',\n 'feedback.dialogue.complete': 'Thank you! Your feedback has been recorded.',\n 'feedback.dialogue.turnPrompt': 'Your response:',\n\n // Feedback types\n 'feedback.types.bug': 'Bug report',\n 'feedback.types.feature': 'Feature request',\n 'feedback.types.ux': 'UX improvement',\n 'feedback.types.other': 'Other',\n\n // Status messages\n 'feedback.status.submitting': 'Submitting your feedback...',\n 'feedback.status.success': 'Feedback submitted successfully!',\n 'feedback.status.error': 'Failed to submit feedback. Please try again.',\n 'feedback.status.retry': 'Retry',\n 'feedback.status.duplicate': 'This feedback has already been submitted.',\n\n // Toast messages\n 'feedback.toast.screenshotAdded': 'Screenshot attached',\n 'feedback.toast.screenshotRemoved': 'Screenshot removed',\n 'feedback.toast.screenshotError': 'Failed to capture screenshot',\n\n // Sign-off messages\n 'feedback.signoff.confirmLabel': 'Mark as resolved',\n 'feedback.signoff.reopenLabel': 'Reopen',\n 'feedback.signoff.autoConfirmNotice':\n 'This issue will be marked resolved in {{days}} days unless you reopen it.',\n\n // Correction messages\n 'feedback.correction.editLabel': 'Edit',\n 'feedback.correction.reasonLabel': 'Reason for change',\n 'feedback.correction.saveLabel': 'Save changes',\n};\n","/**\n * Dutch (nl) translations for the feedback package.\n * Key format: feedback.{component}.{element}\n */\nexport const nl: Record<string, string> = {\n // Button labels\n 'feedback.button.open': 'Feedback',\n 'feedback.button.close': 'Sluiten',\n 'feedback.button.screenshot': 'Screenshot toevoegen',\n 'feedback.button.removeScreenshot': 'Screenshot verwijderen',\n 'feedback.button.submit': 'Feedback versturen',\n\n // Form labels\n 'feedback.form.contentLabel': 'Wat wilt u delen?',\n 'feedback.form.contentPlaceholder': 'Beschrijf het probleem of de suggestie in detail...',\n 'feedback.form.typeLabel': 'Type',\n 'feedback.form.typePlaceholder': 'Selecteer een type',\n\n // Dialogue states\n 'feedback.dialogue.opening': 'Bedankt voor uw feedback. Ik heb een paar vragen om dit beter te begrijpen.',\n 'feedback.dialogue.thinking': 'Aan het nadenken...',\n 'feedback.dialogue.error': 'Er is iets misgegaan. Probeer het opnieuw.',\n 'feedback.dialogue.complete': 'Bedankt! Uw feedback is geregistreerd.',\n 'feedback.dialogue.turnPrompt': 'Uw antwoord:',\n\n // Feedback types\n 'feedback.types.bug': 'Foutmelding',\n 'feedback.types.feature': 'Functiewens',\n 'feedback.types.ux': 'UX-verbetering',\n 'feedback.types.other': 'Overig',\n\n // Status messages\n 'feedback.status.submitting': 'Feedback verzenden...',\n 'feedback.status.success': 'Feedback succesvol verzonden!',\n 'feedback.status.error': 'Verzenden mislukt. Probeer het opnieuw.',\n 'feedback.status.retry': 'Opnieuw proberen',\n 'feedback.status.duplicate': 'Deze feedback is al ingediend.',\n\n // Toast messages\n 'feedback.toast.screenshotAdded': 'Screenshot bijgevoegd',\n 'feedback.toast.screenshotRemoved': 'Screenshot verwijderd',\n 'feedback.toast.screenshotError': 'Screenshot maken mislukt',\n\n // Sign-off messages\n 'feedback.signoff.confirmLabel': 'Markeer als opgelost',\n 'feedback.signoff.reopenLabel': 'Heropenen',\n 'feedback.signoff.autoConfirmNotice':\n 'Dit probleem wordt als opgelost gemarkeerd over {{days}} dagen, tenzij u het heropent.',\n\n // Correction messages\n 'feedback.correction.editLabel': 'Bewerken',\n 'feedback.correction.reasonLabel': 'Reden voor wijziging',\n 'feedback.correction.saveLabel': 'Wijzigingen opslaan',\n};\n","/**\n * Internationalisation utilities for the feedback package.\n *\n * t() falls back gracefully:\n * - Unknown locale → English\n * - Unknown key → returns the key itself (never undefined)\n *\n * Template interpolation: {{param}} → replaced with params values\n */\n\nimport { en } from './locales/en.js';\nimport { nl } from './locales/nl.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Constants\n// ─────────────────────────────────────────────────────────────────\n\n/** Supported locale codes */\nexport const SUPPORTED_LOCALES: readonly string[] = ['en', 'nl'] as const;\n\n/** Default locale when unknown locale is requested */\nexport const DEFAULT_LOCALE = 'en';\n\n/** Built-in translations keyed by locale */\nconst BUILT_IN_TRANSLATIONS: Record<string, Record<string, string>> = {\n en,\n nl,\n};\n\n// ─────────────────────────────────────────────────────────────────\n// Translation Function\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Looks up a translation key.\n *\n * Fallback chain:\n * 1. customTranslations[locale][key]\n * 2. BUILT_IN_TRANSLATIONS[locale][key]\n * 3. BUILT_IN_TRANSLATIONS['en'][key]\n * 4. key itself (never returns undefined or throws)\n *\n * Template interpolation: {{days}} → params.days (if params provided)\n *\n * @param key - Dot-notation key e.g. 'feedback.button.open'\n * @param locale - BCP 47 locale code e.g. 'en', 'nl'\n * @param customTranslations - Optional custom translations (overrides built-in)\n * @param params - Optional template parameters e.g. { days: 7 }\n */\nexport function t(\n key: string,\n locale: string,\n customTranslations?: Record<string, Record<string, string>>,\n params?: Record<string, string | number>,\n): string {\n // 1. Check custom translations for this locale\n const customForLocale = customTranslations?.[locale];\n if (customForLocale?.[key] !== undefined) {\n return interpolate(customForLocale[key], params);\n }\n\n // 2. Check custom translations for English fallback\n const customEn = customTranslations?.['en'];\n if (locale !== 'en' && customEn?.[key] !== undefined) {\n // Only use English custom if locale not found\n }\n\n // 3. Check built-in translations for this locale\n const builtInForLocale = BUILT_IN_TRANSLATIONS[locale];\n if (builtInForLocale?.[key] !== undefined) {\n return interpolate(builtInForLocale[key] as string, params);\n }\n\n // 4. Fall back to English built-in\n const englishBuiltIn = BUILT_IN_TRANSLATIONS['en'];\n if (englishBuiltIn?.[key] !== undefined) {\n return interpolate(englishBuiltIn[key] as string, params);\n }\n\n // 5. Fall back to English custom (if provided)\n if (customEn?.[key] !== undefined) {\n return interpolate(customEn[key] as string, params);\n }\n\n // 6. Return the key itself — never undefined\n return key;\n}\n\n/**\n * Replaces {{param}} placeholders with values from params.\n */\nfunction interpolate(\n template: string,\n params?: Record<string, string | number>,\n): string {\n if (!params) return template;\n return template.replace(/\\{\\{(\\w+)\\}\\}/g, (_match, name: string) => {\n const value = params[name];\n return value !== undefined ? String(value) : `{{${name}}}`;\n });\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Locale Detection\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Returns the locale to use.\n * If preferredLocale is a supported locale → return it.\n * Otherwise → return DEFAULT_LOCALE ('en').\n *\n * @param preferredLocale - BCP 47 locale code or undefined\n */\nexport function detectLocale(preferredLocale?: string): string {\n if (preferredLocale && SUPPORTED_LOCALES.includes(preferredLocale)) {\n return preferredLocale;\n }\n return DEFAULT_LOCALE;\n}\n"],"names":[],"mappings":"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"}
|