@trokky/trokky 2.0.3

package/dist/core/utils/reference-expander.js

@@ -0,0 +1,192 @@
+/**
+ * Reference Expander Utility
+ * Expands reference fields in documents by fetching the referenced documents
+ */
+/**
+ * Check if a value is a reference
+ */
+export function isReference(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '_ref' in value &&
+        '_type' in value &&
+        typeof value._ref === 'string' &&
+        typeof value._type === 'string');
+}
+/**
+ * Find all reference fields in a schema
+ */
+export function findReferenceFields(schema, prefix = '') {
+    const referenceFields = [];
+    const fields = schema.fields || {};
+    for (const [fieldName, fieldDef] of Object.entries(fields)) {
+        const fieldPath = prefix ? `${prefix}.${fieldName}` : fieldName;
+        const field = fieldDef;
+        if (field.type === 'reference') {
+            referenceFields.push(fieldPath);
+        }
+        else if (field.type === 'object' && field.fields) {
+            // Recursively find references in nested objects
+            const nestedSchema = { fields: field.fields };
+            const nestedRefs = findReferenceFields(nestedSchema, fieldPath);
+            referenceFields.push(...nestedRefs);
+        }
+        else if (field.type === 'array' && field.of) {
+            // Check if array contains references
+            const arrayOf = field.of;
+            if (arrayOf.type === 'reference') {
+                referenceFields.push(`${fieldPath}[]`);
+            }
+            else if (arrayOf.type === 'object' && arrayOf.fields) {
+                // Array of objects with potential references
+                const nestedSchema = { fields: arrayOf.fields };
+                const nestedRefs = findReferenceFields(nestedSchema, `${fieldPath}[]`);
+                referenceFields.push(...nestedRefs);
+            }
+        }
+    }
+    return referenceFields;
+}
+/**
+ * Get a nested value from a document using dot notation
+ */
+function getNestedValue(obj, path) {
+    const parts = path.replace(/\[\]/g, '').split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Set a nested value in a document using dot notation
+ */
+function setNestedValue(obj, path, value) {
+    const parts = path.replace(/\[\]/g, '').split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!(part in current) || typeof current[part] !== 'object') {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+/**
+ * Expand references in a single document
+ */
+export async function expandDocumentReferences(document, options, fetchDocument, getSchema) {
+    const { fields, maxDepth = 1, currentDepth = 0 } = options;
+    if (currentDepth >= maxDepth) {
+        return document;
+    }
+    // Create a copy to avoid mutating the original
+    const expanded = { ...document };
+    // Collect all references to fetch
+    const referencesToFetch = new Map();
+    for (const fieldPath of fields) {
+        const isArrayField = fieldPath.includes('[]');
+        const cleanPath = fieldPath.replace(/\[\]/g, '');
+        const value = getNestedValue(expanded, cleanPath);
+        if (isArrayField && Array.isArray(value)) {
+            // Handle array of references
+            for (let i = 0; i < value.length; i++) {
+                const item = value[i];
+                if (isReference(item)) {
+                    const key = `${item._type}:${item._ref}`;
+                    if (!referencesToFetch.has(key)) {
+                        referencesToFetch.set(key, {
+                            collection: item._type,
+                            id: item._ref,
+                            paths: []
+                        });
+                    }
+                    referencesToFetch.get(key).paths.push(`${cleanPath}.${i}`);
+                }
+            }
+        }
+        else if (isReference(value)) {
+            // Handle single reference
+            const key = `${value._type}:${value._ref}`;
+            if (!referencesToFetch.has(key)) {
+                referencesToFetch.set(key, {
+                    collection: value._type,
+                    id: value._ref,
+                    paths: []
+                });
+            }
+            referencesToFetch.get(key).paths.push(cleanPath);
+        }
+    }
+    // Fetch all referenced documents in parallel
+    const fetchPromises = Array.from(referencesToFetch.entries()).map(async ([key, { collection, id, paths }]) => {
+        try {
+            const referencedDoc = await fetchDocument(collection, id);
+            return { key, document: referencedDoc, paths };
+        }
+        catch (error) {
+            console.warn(`Failed to expand reference ${collection}/${id}:`, error);
+            return { key, document: null, paths };
+        }
+    });
+    const results = await Promise.all(fetchPromises);
+    // Apply expanded documents
+    for (const { document: referencedDoc, paths } of results) {
+        if (referencedDoc) {
+            for (const path of paths) {
+                // Check if path is an array index path (e.g., "authors.0")
+                const pathParts = path.split('.');
+                const lastPart = pathParts[pathParts.length - 1];
+                const isArrayIndex = /^\d+$/.test(lastPart);
+                if (isArrayIndex) {
+                    // Handle array item expansion
+                    const arrayPath = pathParts.slice(0, -1).join('.');
+                    const index = parseInt(lastPart, 10);
+                    const array = getNestedValue(expanded, arrayPath);
+                    if (Array.isArray(array) && array[index]) {
+                        array[index] = referencedDoc;
+                    }
+                }
+                else {
+                    setNestedValue(expanded, path, referencedDoc);
+                }
+            }
+        }
+    }
+    return expanded;
+}
+/**
+ * Expand references in multiple documents
+ */
+export async function expandDocumentsReferences(documents, options, fetchDocument, getSchema) {
+    // Process all documents in parallel
+    return Promise.all(documents.map(doc => expandDocumentReferences(doc, options, fetchDocument, getSchema)));
+}
+/**
+ * Parse expand parameter from query string
+ * Supports formats:
+ * - "field1,field2" - comma-separated field names
+ * - "field1,field2[]" - array fields with [] suffix
+ * - "*" - expand all reference fields (requires schema)
+ */
+export function parseExpandParam(expandParam, schema) {
+    if (!expandParam)
+        return [];
+    // Handle array of expand params
+    const expandString = Array.isArray(expandParam) ? expandParam.join(',') : expandParam;
+    // Handle wildcard expansion
+    if (expandString === '*' && schema) {
+        return findReferenceFields(schema);
+    }
+    // Parse comma-separated fields
+    return expandString
+        .split(',')
+        .map(f => f.trim())
+        .filter(f => f.length > 0);
+}
+//# sourceMappingURL=reference-expander.js.map

package/dist/core/utils/reference-expander.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-expander.js","sourceRoot":"","sources":["../../../src/core/utils/reference-expander.ts"],"names":[],"mappings":"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"}

package/dist/core/utils/universal-crypto.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Universal crypto utilities that work across all JavaScript environments
+ * Supports: Browser, Node.js, Cloudflare Workers, Deno, Bun, etc.
+ */
+export interface UniversalCrypto {
+    getRandomBytes(length: number): Uint8Array;
+}
+/**
+ * Detect and return the best crypto implementation for the current environment
+ */
+export declare function getUniversalCrypto(): UniversalCrypto;
+/**
+ * Convert byte array to hex string
+ */
+export declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Generate a cryptographically secure random hex string
+ */
+export declare function generateRandomHex(length: number): string;
+/**
+ * Generate a UUID v4
+ */
+export declare function generateUUID(): string;
+/**
+ * Generate a cryptographically secure random integer between 0 and max (exclusive)
+ * Uses rejection sampling to avoid modulo bias
+ */
+export declare function getSecureRandomInt(max: number): number;
+/**
+ * Cryptographically secure array shuffling using Fisher-Yates algorithm
+ */
+export declare function secureShuffleArray<T>(array: T[]): T[];
+/**
+ * Generate a cryptographically secure password
+ */
+export interface SecurePasswordOptions {
+    length?: number;
+    includeUppercase?: boolean;
+    includeLowercase?: boolean;
+    includeNumbers?: boolean;
+    includeSpecialChars?: boolean;
+    customChars?: string;
+    excludeSimilar?: boolean;
+}
+export declare function generateSecurePassword(options?: SecurePasswordOptions): string;
+//# sourceMappingURL=universal-crypto.d.ts.map

package/dist/core/utils/universal-crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal-crypto.d.ts","sourceRoot":"","sources":["../../../src/core/utils/universal-crypto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;CAC3C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAkCpD;AAeD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAgBrC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsBtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CASrD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAiElF"}

package/dist/core/utils/universal-crypto.js

@@ -0,0 +1,171 @@
+/**
+ * Universal crypto utilities that work across all JavaScript environments
+ * Supports: Browser, Node.js, Cloudflare Workers, Deno, Bun, etc.
+ */
+/**
+ * Detect and return the best crypto implementation for the current environment
+ */
+export function getUniversalCrypto() {
+    // Web Crypto API (browser, Cloudflare Workers, Deno)
+    if (typeof globalThis !== 'undefined' && globalThis.crypto && 'getRandomValues' in globalThis.crypto) {
+        return {
+            getRandomBytes(length) {
+                const array = new Uint8Array(length);
+                globalThis.crypto.getRandomValues(array);
+                return array;
+            }
+        };
+    }
+    // Node.js environment - use dynamic require detection to avoid bundling
+    if (typeof process !== 'undefined' && process.versions && process.versions.node) {
+        return {
+            getRandomBytes(length) {
+                try {
+                    // Use dynamic require detection to prevent bundlers from trying to resolve this
+                    const requireFunc = typeof require !== 'undefined' ? require : null;
+                    if (!requireFunc)
+                        throw new Error('require not available');
+                    const crypto = requireFunc('crypto');
+                    return new Uint8Array(crypto.randomBytes(length));
+                }
+                catch (error) {
+                    // Fallback if crypto is not available
+                    return getFallbackRandomBytes(length);
+                }
+            }
+        };
+    }
+    // Fallback for any other environment
+    return {
+        getRandomBytes: getFallbackRandomBytes
+    };
+}
+/**
+ * Fallback random bytes implementation using Math.random()
+ * Not cryptographically secure - only for environments without crypto support
+ */
+function getFallbackRandomBytes(length) {
+    console.warn('⚠️ Using Math.random() fallback for crypto operations. This is not cryptographically secure.');
+    const array = new Uint8Array(length);
+    for (let i = 0; i < length; i++) {
+        array[i] = Math.floor(Math.random() * 256);
+    }
+    return array;
+}
+/**
+ * Convert byte array to hex string
+ */
+export function bytesToHex(bytes) {
+    return Array.from(bytes, byte => byte.toString(16).padStart(2, '0')).join('');
+}
+/**
+ * Generate a cryptographically secure random hex string
+ */
+export function generateRandomHex(length) {
+    const crypto = getUniversalCrypto();
+    const bytes = crypto.getRandomBytes(Math.ceil(length / 2));
+    return bytesToHex(bytes).slice(0, length);
+}
+/**
+ * Generate a UUID v4
+ */
+export function generateUUID() {
+    const crypto = getUniversalCrypto();
+    const bytes = crypto.getRandomBytes(16);
+    // Set version (4) and variant bits
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytesToHex(bytes);
+    return [
+        hex.slice(0, 8),
+        hex.slice(8, 12),
+        hex.slice(12, 16),
+        hex.slice(16, 20),
+        hex.slice(20, 32)
+    ].join('-');
+}
+/**
+ * Generate a cryptographically secure random integer between 0 and max (exclusive)
+ * Uses rejection sampling to avoid modulo bias
+ */
+export function getSecureRandomInt(max) {
+    if (max <= 0)
+        throw new Error('Max must be positive');
+    if (max === 1)
+        return 0;
+    const crypto = getUniversalCrypto();
+    // Determine how many bytes we need to represent max
+    const byteCount = Math.ceil(Math.log2(max) / 8) || 1;
+    const maxVal = Math.pow(256, byteCount);
+    const threshold = maxVal - (maxVal % max);
+    while (true) {
+        const bytes = crypto.getRandomBytes(byteCount);
+        let value = 0;
+        for (let i = 0; i < byteCount; i++) {
+            value = (value * 256) + bytes[i];
+        }
+        // Rejection sampling to avoid modulo bias
+        if (value < threshold) {
+            return value % max;
+        }
+    }
+}
+/**
+ * Cryptographically secure array shuffling using Fisher-Yates algorithm
+ */
+export function secureShuffleArray(array) {
+    const result = [...array];
+    for (let i = result.length - 1; i > 0; i--) {
+        const j = getSecureRandomInt(i + 1);
+        [result[i], result[j]] = [result[j], result[i]];
+    }
+    return result;
+}
+export function generateSecurePassword(options = {}) {
+    const { length = 16, includeUppercase = true, includeLowercase = true, includeNumbers = true, includeSpecialChars = true, customChars = '', excludeSimilar = false } = options;
+    if (length < 1)
+        throw new Error('Password length must be at least 1');
+    if (length > 1000)
+        throw new Error('Password length too large');
+    let charset = '';
+    const requiredChars = [];
+    // Build character sets
+    if (includeLowercase) {
+        const lowercase = excludeSimilar ? 'abcdefghijkmnopqrstuvwxyz' : 'abcdefghijklmnopqrstuvwxyz';
+        charset += lowercase;
+        requiredChars.push(lowercase[getSecureRandomInt(lowercase.length)]);
+    }
+    if (includeUppercase) {
+        const uppercase = excludeSimilar ? 'ABCDEFGHJKLMNPQRSTUVWXYZ' : 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+        charset += uppercase;
+        requiredChars.push(uppercase[getSecureRandomInt(uppercase.length)]);
+    }
+    if (includeNumbers) {
+        const numbers = excludeSimilar ? '23456789' : '0123456789';
+        charset += numbers;
+        requiredChars.push(numbers[getSecureRandomInt(numbers.length)]);
+    }
+    if (includeSpecialChars) {
+        const special = '!@#$%^&*()_+-=[]{}|;:,.<>?';
+        charset += special;
+        requiredChars.push(special[getSecureRandomInt(special.length)]);
+    }
+    if (customChars) {
+        charset += customChars;
+    }
+    if (!charset) {
+        throw new Error('At least one character type must be included');
+    }
+    // Convert charset to array for secure selection
+    const charArray = charset.split('');
+    // Start with required characters
+    const passwordChars = [...requiredChars];
+    // Fill remaining length with random characters from full charset
+    while (passwordChars.length < length) {
+        const randomIndex = getSecureRandomInt(charArray.length);
+        passwordChars.push(charArray[randomIndex]);
+    }
+    // Securely shuffle the password to avoid predictable patterns
+    return secureShuffleArray(passwordChars).join('');
+}
+//# sourceMappingURL=universal-crypto.js.map

package/dist/core/utils/universal-crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal-crypto.js","sourceRoot":"","sources":["../../../src/core/utils/universal-crypto.ts"],"names":[],"mappings":"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"}

package/dist/core/validation/validator.d.ts

@@ -0,0 +1,11 @@
+import { SchemaRegistry } from '../schema/registry.js';
+import { ValidationResult } from '../types/index.js';
+export declare class DocumentValidator {
+    private schemaRegistry;
+    constructor(schemaRegistry: SchemaRegistry);
+    validateDocument(collection: string, data: unknown): ValidationResult;
+    private buildZodSchema;
+    private buildFieldSchema;
+    private formatZodErrors;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/core/validation/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/core/validation/validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAmB,gBAAgB,EAAyB,MAAM,mBAAmB,CAAA;AAE5F,qBAAa,iBAAiB;IAChB,OAAO,CAAC,cAAc;gBAAd,cAAc,EAAE,cAAc;IAE3C,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB;IAwC5E,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,gBAAgB;IAkHxB,OAAO,CAAC,eAAe;CAOxB"}

package/dist/core/validation/validator.js

@@ -0,0 +1,164 @@
+import { z } from 'zod';
+export class DocumentValidator {
+    schemaRegistry;
+    constructor(schemaRegistry) {
+        this.schemaRegistry = schemaRegistry;
+    }
+    validateDocument(collection, data) {
+        const schema = this.schemaRegistry.getSchema(collection);
+        if (!schema) {
+            return {
+                valid: false,
+                errors: [{
+                        field: '_collection',
+                        message: `Schema not found for collection: ${collection}`,
+                        code: 'SCHEMA_NOT_FOUND'
+                    }]
+            };
+        }
+        try {
+            const zodSchema = this.buildZodSchema(schema.fields);
+            zodSchema.parse(data);
+            return {
+                valid: true,
+                errors: []
+            };
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                return {
+                    valid: false,
+                    errors: this.formatZodErrors(error)
+                };
+            }
+            return {
+                valid: false,
+                errors: [{
+                        field: '_root',
+                        message: `Validation error: ${error}`,
+                        code: 'VALIDATION_ERROR'
+                    }]
+            };
+        }
+    }
+    buildZodSchema(fields) {
+        const schemaShape = {};
+        for (const [fieldName, fieldDef] of Object.entries(fields)) {
+            let fieldSchema = this.buildFieldSchema(fieldDef);
+            if (!fieldDef.required) {
+                // The Studio sends null for every field it has no value for
+                fieldSchema = fieldSchema.nullish();
+            }
+            schemaShape[fieldName] = fieldSchema;
+        }
+        return z.object(schemaShape).passthrough();
+    }
+    buildFieldSchema(fieldDef) {
+        const isOptional = !fieldDef.required;
+        switch (fieldDef.type) {
+            case 'string':
+                // Optional strings may be sent as null by the Studio when cleared
+                return isOptional ? z.string().nullable() : z.string();
+            case 'number':
+                // Optional numbers may be sent as null by the Studio when cleared
+                return isOptional ? z.number().nullable() : z.number();
+            case 'boolean':
+                return z.boolean();
+            case 'date':
+                return z.date()
+                    .or(z.string().refine(str => {
+                    // Handle special "now" value
+                    if (str === 'now') {
+                        return true;
+                    }
+                    const date = new Date(str);
+                    return !isNaN(date.getTime());
+                }, { message: 'Invalid date string' }).transform(str => {
+                    // Transform "now" to current date
+                    if (str === 'now') {
+                        return new Date();
+                    }
+                    return new Date(str);
+                }))
+                    .or(z.null()); // Allow null values for optional date fields
+            case 'array':
+                // Use modern 'of' format for array item definition
+                if (!fieldDef.of) {
+                    return z.array(z.unknown());
+                }
+                const itemSchema = this.buildFieldSchema(fieldDef.of);
+                return z.array(itemSchema);
+            case 'object':
+                if (!fieldDef.fields) {
+                    return isOptional ? z.record(z.unknown()).nullable() : z.record(z.unknown());
+                }
+                const objectShape = {};
+                // Handle modern format: fields is a Record<string, FieldDefinition>
+                for (const [propName, propDef] of Object.entries(fieldDef.fields)) {
+                    const typedPropDef = propDef;
+                    let propSchema = this.buildFieldSchema(typedPropDef);
+                    if (!typedPropDef.required) {
+                        // The Studio sends null for every field it has no value for
+                        propSchema = propSchema.nullish();
+                    }
+                    objectShape[propName] = propSchema;
+                }
+                return isOptional ? z.object(objectShape).nullable() : z.object(objectShape);
+            case 'reference': {
+                const referenceValue = z.union([
+                    z.string(), // Still allow string IDs for backward compatibility
+                    z.object({
+                        _ref: z.string(),
+                        _type: z.string().optional()
+                    }).passthrough() // Allow additional metadata
+                ]);
+                // Only an optional reference may be cleared to null
+                return isOptional ? referenceValue.nullable() : referenceValue;
+            }
+            case 'media':
+                // Media fields can be either a string ID, a complex object with asset reference, or null (when removed)
+                return z.union([
+                    z.string(),
+                    z.object({
+                        _type: z.literal('media'),
+                        asset: z.object({
+                            _ref: z.string(),
+                            _type: z.literal('mediaAsset')
+                        }),
+                        alt: z.string().optional(),
+                        caption: z.string().optional(),
+                        title: z.string().optional(),
+                        variant: z.string().optional()
+                    }).passthrough(),
+                    z.null()
+                ]);
+            case 'slug':
+                // TODO(#8): Refactor to use field plugin validation instead of duplicating logic
+                // See: https://github.com/Trokky/trokky/issues/8
+                //
+                // Removed overly restrictive regex validation - let field plugin handle format validation
+                // This allows slugs to be flexible and respect schema-level options like:
+                // - allowSlashes (for hierarchical paths like "blog/posts/my-article")
+                // - preserveCase (for case-sensitive slugs)
+                // - allowedChars (for additional characters like underscores, dots, etc.)
+                //
+                // Basic validation: just ensure it's a string within length limits
+                // Optional slugs may be empty (the slug processor can regenerate them later)
+                {
+                    const maxLength = fieldDef.maxLength || 200;
+                    const slugSchema = z.string().max(maxLength, 'Slug is too long');
+                    return isOptional ? slugSchema : slugSchema.min(1, 'Slug cannot be empty');
+                }
+            default:
+                return z.unknown();
+        }
+    }
+    formatZodErrors(zodError) {
+        return zodError.errors.map(error => ({
+            field: error.path.join('.') || '_root',
+            message: error.message,
+            code: error.code
+        }));
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/core/validation/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../src/core/validation/validator.ts"],"names":[],"mappings":"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"}