ormbridge 0.12.1 → 0.14.0

package/dist/emitters/neomodelNames.js

@@ -0,0 +1,159 @@
+import { toSnakeCase } from '../naming.js';
+/** Name and literal helpers of the neomodel writer. */
+/** Python keywords: an identifier with one of these names does not parse. */
+const PYTHON_KEYWORDS = new Set([
+    'False',
+    'None',
+    'True',
+    'and',
+    'as',
+    'assert',
+    'async',
+    'await',
+    'break',
+    'class',
+    'continue',
+    'def',
+    'del',
+    'elif',
+    'else',
+    'except',
+    'finally',
+    'for',
+    'from',
+    'global',
+    'if',
+    'import',
+    'in',
+    'is',
+    'lambda',
+    'nonlocal',
+    'not',
+    'or',
+    'pass',
+    'raise',
+    'return',
+    'try',
+    'while',
+    'with',
+    'yield',
+]);
+/**
+ * Attribute names that neomodel itself uses on a node or relationship class. A property with one of these
+ * names is refused (`id`, `element_id`, `deleted`, `source`, `target`) or hides a method (`save`, `delete`).
+ */
+export const RESERVED_ATTRIBUTES = new Set([
+    'DoesNotExist',
+    'bulk_save',
+    'create',
+    'create_or_update',
+    'cypher',
+    'defined_properties',
+    'deflate',
+    'delete',
+    'deleted',
+    'element_id',
+    'element_id_property',
+    'end_node',
+    'get_or_create',
+    'id',
+    'inflate',
+    'inherited_labels',
+    'inherited_optional_labels',
+    'labels',
+    'nodes',
+    'refresh',
+    'save',
+    'source',
+    'start_node',
+    'target',
+    'was_saved',
+]);
+/**
+ * Names the generated module imports or defines at the top level. A node class with one of these names
+ * would hide the import, so its class is renamed and the label is kept with `__label__`.
+ */
+export const RESERVED_TYPES = new Set([
+    'AliasProperty',
+    'ArrayProperty',
+    'BooleanProperty',
+    'DateProperty',
+    'DateTimeNeo4jFormatProperty',
+    'datetime',
+    'timezone',
+    'DateTimeProperty',
+    'EmailProperty',
+    'FloatProperty',
+    'FulltextIndex',
+    'IntegerProperty',
+    'JSONProperty',
+    'One',
+    'OneOrMore',
+    'Q',
+    'Relationship',
+    'RelationshipFrom',
+    'RelationshipTo',
+    'StringProperty',
+    'StructuredNode',
+    'StructuredRel',
+    'UniqueIdProperty',
+    'ZeroOrMore',
+    'ZeroOrOne',
+    'date',
+    'uuid4',
+]);
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** True when the text is a plain Python identifier that is not a keyword. */
+export function isPythonIdentifier(text) {
+    return IDENTIFIER.test(text) && !PYTHON_KEYWORDS.has(text);
+}
+/**
+ * The Python attribute name for a graph property key or relation name: snake_case, a leading underscore
+ * before a digit, a trailing underscore when the word is a keyword or one neomodel uses (`id` is `id_`).
+ */
+export function attributeNameOf(raw) {
+    let name = toSnakeCase(raw);
+    if (name === '') {
+        name = 'value';
+    }
+    if (/^[0-9]/.test(name)) {
+        name = `_${name}`;
+    }
+    return PYTHON_KEYWORDS.has(name) || RESERVED_ATTRIBUTES.has(name)
+        ? `${name}_`
+        : name;
+}
+/** Reserves `base` in `used`, appending `_2`, `_3`, ... when the name is taken. */
+export function uniqueAttribute(base, used) {
+    let candidate = base;
+    let suffix = 2;
+    while (used.has(candidate)) {
+        candidate = `${base}_${suffix}`;
+        suffix += 1;
+    }
+    used.add(candidate);
+    return candidate;
+}
+/** Reserves a class name in `used`, appending 2, 3, ... when it is taken. */
+export function uniqueClassName(base, used) {
+    let candidate = base;
+    let suffix = 2;
+    while (used.has(candidate)) {
+        candidate = `${base}${suffix}`;
+        suffix += 1;
+    }
+    used.add(candidate);
+    return candidate;
+}
+/** A class name for a node label: the label when it is a valid identifier, otherwise a repaired form. */
+export function classNameOf(label) {
+    const cleaned = label.replace(/[^A-Za-z0-9_]/g, '_');
+    const prefixed = /^[0-9]/.test(cleaned) ? `_${cleaned}` : cleaned;
+    const named = prefixed === '' ? 'Node' : prefixed;
+    return PYTHON_KEYWORDS.has(named) ? `${named}_` : named;
+}
+/** A Python string literal in double quotes (the JSON escapes are valid Python escapes). */
+export function pyString(value) {
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=neomodelNames.js.map

package/dist/emitters/neomodelNames.js.map

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

package/dist/emitters/neomodelProperties.d.ts

@@ -0,0 +1,48 @@
+import type { IrField, IrSchema } from '../ir.js';
+import type { GraphProperty } from './neo4jGraph.js';
+/** Turns one graph property into a neomodel property class call such as `StringProperty(required=True)`. */
+/** The imports the generated module needs, collected while the classes are planned. */
+export declare class ModuleImports {
+    /** Names imported from `neomodel`. */
+    readonly neomodel: Set<string>;
+    /** `from datetime import date` (the default of a date column). */
+    usesDate: boolean;
+    /** Names imported from `datetime` for the default of a date and time column. */
+    readonly datetime: Set<string>;
+    /** `from uuid import uuid4` (the default of a UUID column). */
+    usesUuid: boolean;
+    /** Records a name of `neomodel` and returns it. */
+    use(name: string): string;
+}
+/** Which indexes and constraints a property takes part in. */
+export interface PropertyRole {
+    unique: boolean;
+    index: boolean;
+    fulltext: boolean;
+}
+/** A property class and its arguments, ready to be laid out. */
+export interface PropertyCall {
+    className: string;
+    args: string[];
+}
+export interface PropertyContext {
+    schema: IrSchema;
+    imports: ModuleImports;
+    warnings: string[];
+}
+export interface PropertyInput {
+    /** `Model.field`, for warnings. */
+    label: string;
+    property: GraphProperty;
+    /** The IR field behind the property; undefined for a foreign key column. */
+    field: IrField | undefined;
+    role: PropertyRole;
+    /** The attribute name in the class; `db_property` is written when it differs from the key. */
+    attribute: string;
+    /** True for the single UUID key of a node, which `UniqueIdProperty` can generate. */
+    uniqueId: boolean;
+}
+/** The text of a call, `Name(arg, arg)`. */
+export declare function callText(call: PropertyCall): string;
+/** Plans the property class and arguments of one graph property. */
+export declare function planProperty(context: PropertyContext, input: PropertyInput): PropertyCall;

package/dist/emitters/neomodelProperties.js

@@ -0,0 +1,220 @@
+import { oneLine } from './neo4jNames.js';
+import { mapFieldType } from './neo4jTypes.js';
+import { pyString } from './neomodelNames.js';
+/** Turns one graph property into a neomodel property class call such as `StringProperty(required=True)`. */
+/** The imports the generated module needs, collected while the classes are planned. */
+export class ModuleImports {
+    /** Names imported from `neomodel`. */
+    neomodel = new Set();
+    /** `from datetime import date` (the default of a date column). */
+    usesDate = false;
+    /** Names imported from `datetime` for the default of a date and time column. */
+    datetime = new Set();
+    /** `from uuid import uuid4` (the default of a UUID column). */
+    usesUuid = false;
+    /** Records a name of `neomodel` and returns it. */
+    use(name) {
+        this.neomodel.add(name);
+        return name;
+    }
+}
+/** The property class for a Neo4j type, plus the note about what neomodel stores instead. */
+function classFor(type, context, label) {
+    const { imports } = context;
+    switch (type.name) {
+        case 'INTEGER':
+            return imports.use('IntegerProperty');
+        case 'FLOAT':
+            return imports.use('FloatProperty');
+        case 'BOOLEAN':
+            return imports.use('BooleanProperty');
+        case 'DATE':
+            return imports.use('DateProperty');
+        case 'ZONED DATETIME':
+        case 'LOCAL DATETIME':
+            return imports.use('DateTimeNeo4jFormatProperty');
+        case 'LOCAL TIME':
+        case 'ZONED TIME':
+            context.warnings.push(`${label}: neomodel has no time property; the value is stored as an ISO 8601 text in a StringProperty.`);
+            return imports.use('StringProperty');
+        case 'DURATION':
+            context.warnings.push(`${label}: neomodel has no duration property; the value is stored as an ISO 8601 text in a StringProperty.`);
+            return imports.use('StringProperty');
+        case 'BYTE ARRAY':
+            context.warnings.push(`${label}: neomodel has no binary property; the value is stored as base64 text in a StringProperty.`);
+            return imports.use('StringProperty');
+        default:
+            return imports.use('StringProperty');
+    }
+}
+function enumOf(field, schema) {
+    return field.enumName === undefined
+        ? undefined
+        : schema.enums.find((candidate) => candidate.name === field.enumName);
+}
+/** `{"draft": "DRAFT", ...}`: the stored value and the name of the member. */
+function choices(definition) {
+    const items = definition.values.map((value) => `${pyString(value.dbValue)}: ${pyString(value.name)}`);
+    return `{${items.join(', ')}}`;
+}
+/** The text of a call, `Name(arg, arg)`. */
+export function callText(call) {
+    return `${call.className}(${call.args.join(', ')})`;
+}
+/** The base property of a field (the element property for an array). */
+function baseCall(context, label, field, type) {
+    if (field !== undefined && field.type === 'json') {
+        return { className: context.imports.use('JSONProperty'), args: [] };
+    }
+    const className = classFor(type, context, label);
+    const args = [];
+    if (className === 'StringProperty' && field !== undefined) {
+        const definition = enumOf(field, context.schema);
+        if (definition !== undefined && type.name === 'STRING') {
+            args.push(`choices=${choices(definition)}`);
+        }
+        else if (field.maxLength !== undefined && field.type === 'string') {
+            args.push(`max_length=${field.maxLength}`);
+        }
+    }
+    if (field !== undefined &&
+        enumOf(field, context.schema) !== undefined &&
+        type.name !== 'STRING') {
+        context.warnings.push(`${label}: neomodel cannot restrict ${className} to the values of enum ${field.enumName ?? ''}; the values are not checked.`);
+    }
+    return { className, args };
+}
+/** The Python text of a default, or undefined (with a warning) when neomodel cannot hold it. */
+function defaultArgs(context, label, field, base, isArray) {
+    const value = field.default ??
+        // A timestamp refreshed on every save starts as the time of the first save.
+        (field.isAutoUpdated &&
+            (base.className === 'DateTimeNeo4jFormatProperty' ||
+                base.className === 'DateProperty')
+            ? { kind: 'now' }
+            : undefined);
+    if (value === undefined || value.kind === 'autoIncrement') {
+        if (value !== undefined) {
+            context.warnings.push(`${label}: auto-increment has no neomodel equivalent; supply the value yourself (a UUID key with UniqueIdProperty needs none).`);
+        }
+        return undefined;
+    }
+    const drop = (what) => {
+        context.warnings.push(`${label}: ${what} has no neomodel equivalent and was dropped; set the value when you create the node.`);
+        return undefined;
+    };
+    if (isArray) {
+        return drop('the default of an array');
+    }
+    switch (value.kind) {
+        case 'literal':
+            return literalArgs(value.value, base.className, drop);
+        case 'now':
+            if (base.className === 'DateTimeNeo4jFormatProperty') {
+                // DateTimeNeo4jFormatProperty(default_now=True) would fix the time when the module is imported.
+                if (mapFieldType(field).type.name === 'LOCAL DATETIME') {
+                    context.imports.datetime.add('datetime');
+                    return ['default=datetime.now'];
+                }
+                context.imports.datetime.add('datetime').add('timezone');
+                return ['default=lambda: datetime.now(timezone.utc)'];
+            }
+            if (base.className === 'DateProperty') {
+                context.imports.usesDate = true;
+                return ['default=date.today'];
+            }
+            return drop('the default of the current time');
+        case 'uuid':
+            if (base.className === 'StringProperty') {
+                context.imports.usesUuid = true;
+                return ['default=lambda: str(uuid4())'];
+            }
+            return drop('the default of a generated UUID');
+        case 'enumValue': {
+            const definition = enumOf(field, context.schema);
+            const member = definition?.values.find((candidate) => candidate.name === value.value);
+            return base.className === 'StringProperty'
+                ? [`default=${pyString(member?.dbValue ?? value.value)}`]
+                : drop(`the default "${value.value}"`);
+        }
+        case 'clientGenerated':
+            return drop(`the ${value.generator}() default`);
+        case 'dbExpression':
+            return drop(`the database default ${oneLine(value.expression)}`);
+    }
+}
+function literalArgs(value, className, drop) {
+    const fits = (className === 'StringProperty' && typeof value !== 'boolean') ||
+        (className === 'IntegerProperty' &&
+            typeof value === 'number' &&
+            Number.isInteger(value)) ||
+        (className === 'FloatProperty' &&
+            typeof value === 'number' &&
+            Number.isFinite(value)) ||
+        (className === 'BooleanProperty' && typeof value === 'boolean');
+    if (!fits) {
+        return drop(`the default ${JSON.stringify(value)}`);
+    }
+    if (typeof value === 'boolean') {
+        return [`default=${value ? 'True' : 'False'}`];
+    }
+    if (className === 'StringProperty') {
+        return [`default=${pyString(String(value))}`];
+    }
+    const text = String(value);
+    return [
+        `default=${className === 'FloatProperty' && /^-?\d+$/.test(text) ? `${text}.0` : text}`,
+    ];
+}
+/** Plans the property class and arguments of one graph property. */
+export function planProperty(context, input) {
+    const { label, property, field, role, attribute } = input;
+    const dbProperty = attribute === property.key ? [] : [`db_property=${pyString(property.key)}`];
+    if (input.uniqueId) {
+        return {
+            className: context.imports.use('UniqueIdProperty'),
+            args: dbProperty,
+        };
+    }
+    const isArray = property.type.name.startsWith('LIST<');
+    let call;
+    if (isArray && field !== undefined) {
+        const element = mapFieldType({
+            ...field,
+            arrayDepth: undefined,
+        }).type;
+        const base = baseCall(context, label, field, element);
+        call = {
+            className: context.imports.use('ArrayProperty'),
+            args: [callText(base)],
+        };
+    }
+    else {
+        call = baseCall(context, label, field, property.type);
+    }
+    const flags = [];
+    if (role.unique) {
+        flags.push('unique_index=True');
+    }
+    else if (role.index) {
+        flags.push('index=True');
+    }
+    if (role.fulltext) {
+        if (call.className === 'StringProperty') {
+            flags.push(`fulltext_index=${context.imports.use('FulltextIndex')}()`);
+        }
+        else {
+            context.warnings.push(`${label}: a full-text index needs a string property, so it was dropped.`);
+        }
+    }
+    const defaults = field === undefined
+        ? []
+        : (defaultArgs(context, label, field, call, isArray) ?? []);
+    const hasDefault = defaults.length > 0;
+    const required = property.required && !hasDefault ? ['required=True'] : [];
+    return {
+        className: call.className,
+        args: [...call.args, ...flags, ...required, ...defaults, ...dbProperty],
+    };
+}
+//# sourceMappingURL=neomodelProperties.js.map

package/dist/emitters/neomodelProperties.js.map

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

package/dist/emitters/sdn.d.ts

@@ -0,0 +1,27 @@
+import type { MultiFileEmitOutput } from '../formats.js';
+import type { IrSchema } from '../ir.js';
+/**
+ * Spring Data Neo4j writer (Java, SDN 7 with Spring Boot 3).
+ *
+ * Writes one `@Node("Label")` class per node label, a Java `enum` per enum (with a
+ * `Neo4jPersistentPropertyConverter` when the stored values differ from the constant names), and a
+ * `@RelationshipProperties` class for every direction of a join table that has extra columns. Properties
+ * whose graph key differs from the Java name carry `@Property`. Relationships are `@Relationship` fields with
+ * the type and the direction, a single value or a `List`. Labels and relationship types are the ones of the
+ * Cypher writer, so the three Neo4j outputs agree. Foreign key columns stay as plain properties.
+ *
+ * The identifier follows the source key: a generated integer is Neo4j's internal id (`@GeneratedValue`), a
+ * generated UUID a `UUIDStringGenerator` string, any other single column an assigned `@Id`; a composite or
+ * missing key becomes a generated internal id `graphId` and the key columns are plain properties.
+ */
+export { isValidJavaPackage } from './jpaNames.js';
+export declare const DEFAULT_SDN_PACKAGE: string;
+export interface SdnEmitOptions {
+    /** Use camelCase graph property keys (the `normalize` naming mode); otherwise the column names are kept. */
+    camelFields: boolean;
+    /** Java package of the generated classes; defaults to `app.models`. */
+    packageName?: string;
+    /** Write the `// <auto-generated>` comment at the top of every file (default true). */
+    header?: boolean;
+}
+export declare function emitSdn(schema: IrSchema, options: SdnEmitOptions): MultiFileEmitOutput;