@ronin/compiler 0.17.13 → 0.17.14-leo-ron-1113-experimental-405

package/dist/index.d.ts

@@ -1,3 +1,13 @@
+/** Query types used for reading data. */
+declare const DML_QUERY_TYPES_READ: readonly ["get", "count"];
+/** Query types used for writing data. */
+declare const DML_QUERY_TYPES_WRITE: readonly ["set", "add", "remove"];
+/** Query types used for interacting with data. */
+declare const DML_QUERY_TYPES: readonly ["get", "count", "set", "add", "remove"];
+/** Query types used for interacting with the database schema. */
+declare const DDL_QUERY_TYPES: readonly ["create", "alter", "drop"];
+/** All query types. */
+declare const QUERY_TYPES: readonly ["get", "count", "set", "add", "remove", "create", "alter", "drop"];
 /**
  * A list of placeholders that can be located inside queries after those queries were
  * serialized into JSON objects.
@@ -15,46 +25,9 @@ declare const QUERY_SYMBOLS: {
     readonly FIELD_PARENT_NEW: "__RONIN_FIELD_PARENT_NEW_";
     readonly VALUE: "__RONIN_VALUE";
 };
-type RoninErrorCode = 'MODEL_NOT_FOUND' | 'FIELD_NOT_FOUND' | 'INDEX_NOT_FOUND' | 'TRIGGER_NOT_FOUND' | 'PRESET_NOT_FOUND' | 'INVALID_WITH_VALUE' | 'INVALID_TO_VALUE' | 'INVALID_INCLUDING_VALUE' | 'INVALID_FOR_VALUE' | 'INVALID_BEFORE_OR_AFTER_INSTRUCTION' | 'INVALID_MODEL_VALUE' | 'EXISTING_MODEL_ENTITY' | 'REQUIRED_MODEL_ENTITY' | 'MUTUALLY_EXCLUSIVE_INSTRUCTIONS' | 'MISSING_INSTRUCTION' | 'MISSING_FIELD';
-interface Issue {
-    message: string;
-    path: Array<string | number>;
-}
-interface Details {
-    message: string;
-    code: RoninErrorCode;
-    field?: string;
-    fields?: Array<string>;
-    issues?: Array<Issue>;
-    queries?: Array<Query> | null;
-}
-declare class RoninError extends Error {
-    code: Details['code'];
-    field?: Details['field'];
-    fields?: Details['fields'];
-    issues?: Details['issues'];
-    queries?: Details['queries'];
-    constructor(details: Details);
-}
-/**
- * Checks if the provided value contains a RONIN model symbol (a represenation of a
- * particular entity inside a query, such as an expression or a sub query) and returns
- * its type and value.
- *
- * @param value - The value that should be checked.
- *
- * @returns The type and value of the symbol, if the provided value contains one.
- */
-declare const getQuerySymbol: (value: unknown) => {
-    type: "query";
-    value: Query;
-} | {
-    type: "expression";
-    value: string;
-} | null;
 
-type QueryTypeEnum = 'get' | 'set' | 'add' | 'remove' | 'count';
-type ModelQueryTypeEnum = 'create' | 'alter' | 'drop';
+type QueryTypeEnum = (typeof DML_QUERY_TYPES)[number];
+type ModelQueryTypeEnum = (typeof DDL_QUERY_TYPES)[number];
 type ModelEntityEnum = 'field' | 'index' | 'trigger' | 'preset';
 type FieldValue = string | number | boolean | null | unknown;
 type FieldSelector = Record<string, FieldValue | StoredObject>;
@@ -426,6 +399,44 @@ type ExpandedResult<T = ResultRecord> = {
 };
 type Result<T = ResultRecord> = RegularResult<T> | ExpandedResult<T>;
 
+type RoninErrorCode = 'MODEL_NOT_FOUND' | 'FIELD_NOT_FOUND' | 'INDEX_NOT_FOUND' | 'TRIGGER_NOT_FOUND' | 'PRESET_NOT_FOUND' | 'INVALID_WITH_VALUE' | 'INVALID_TO_VALUE' | 'INVALID_INCLUDING_VALUE' | 'INVALID_FOR_VALUE' | 'INVALID_BEFORE_OR_AFTER_INSTRUCTION' | 'INVALID_MODEL_VALUE' | 'EXISTING_MODEL_ENTITY' | 'REQUIRED_MODEL_ENTITY' | 'MUTUALLY_EXCLUSIVE_INSTRUCTIONS' | 'MISSING_INSTRUCTION' | 'MISSING_FIELD';
+interface Issue {
+    message: string;
+    path: Array<string | number>;
+}
+interface Details {
+    message: string;
+    code: RoninErrorCode;
+    field?: string;
+    fields?: Array<string>;
+    issues?: Array<Issue>;
+    queries?: Array<Query> | null;
+}
+declare class RoninError extends Error {
+    code: Details['code'];
+    field?: Details['field'];
+    fields?: Details['fields'];
+    issues?: Details['issues'];
+    queries?: Details['queries'];
+    constructor(details: Details);
+}
+/**
+ * Checks if the provided value contains a RONIN model symbol (a represenation of a
+ * particular entity inside a query, such as an expression or a sub query) and returns
+ * its type and value.
+ *
+ * @param value - The value that should be checked.
+ *
+ * @returns The type and value of the symbol, if the provided value contains one.
+ */
+declare const getQuerySymbol: (value: unknown) => {
+    type: "query";
+    value: Query;
+} | {
+    type: "expression";
+    value: string;
+} | null;
+
 interface TransactionOptions {
     /** A list of models that already exist in the database. */
     models?: Array<PublicModel>;
@@ -464,4 +475,4 @@ declare class Transaction {
 
 declare const CLEAN_ROOT_MODEL: PublicModel;
 
-export { type AddInstructions, type AddQuery, type AddInstructions as AddQueryInstructions, type AlterQuery, type CombinedInstructions, type CountInstructions, type CountQuery, type CountInstructions as CountQueryInstructions, type CreateQuery, type DropQuery, type ExpandedResult, type GetInstructions, type GetQuery, type GetInstructions as GetQueryInstructions, type PublicModel as Model, type ModelField, type ModelIndex, type ModelPreset, type ModelTrigger, QUERY_SYMBOLS, type Query, type QueryInstructionType as QueryInstruction, type QuerySchemaType, type QueryType, CLEAN_ROOT_MODEL as ROOT_MODEL, type RegularResult, type RemoveInstructions, type RemoveQuery, type RemoveInstructions as RemoveQueryInstructions, type Result, type ResultRecord, RoninError, type SetInstructions, type SetQuery, type SetInstructions as SetQueryInstructions, type Statement, type StoredObject, Transaction, type WithInstruction, getQuerySymbol };
+export { type AddInstructions, type AddQuery, type AddInstructions as AddQueryInstructions, type AlterQuery, type CombinedInstructions, type CountInstructions, type CountQuery, type CountInstructions as CountQueryInstructions, type CreateQuery, DDL_QUERY_TYPES, DML_QUERY_TYPES, DML_QUERY_TYPES_READ, DML_QUERY_TYPES_WRITE, type DropQuery, type ExpandedResult, type GetInstructions, type GetQuery, type GetInstructions as GetQueryInstructions, type PublicModel as Model, type ModelField, type ModelIndex, type ModelPreset, type ModelTrigger, QUERY_SYMBOLS, QUERY_TYPES, type Query, type QueryInstructionType as QueryInstruction, type QuerySchemaType, type QueryType, CLEAN_ROOT_MODEL as ROOT_MODEL, type RegularResult, type RemoveInstructions, type RemoveQuery, type RemoveInstructions as RemoveQueryInstructions, type Result, type ResultRecord, RoninError, type SetInstructions, type SetQuery, type SetInstructions as SetQueryInstructions, type Statement, type StoredObject, Transaction, type WithInstruction, getQuerySymbol };

package/dist/index.js

@@ -1,4 +1,12 @@
-// src/utils/helpers.ts
+// src/utils/constants.ts
+var DML_QUERY_TYPES_READ = ["get", "count"];
+var DML_QUERY_TYPES_WRITE = ["set", "add", "remove"];
+var DML_QUERY_TYPES = [
+  ...DML_QUERY_TYPES_READ,
+  ...DML_QUERY_TYPES_WRITE
+];
+var DDL_QUERY_TYPES = ["create", "alter", "drop"];
+var QUERY_TYPES = [...DML_QUERY_TYPES, ...DDL_QUERY_TYPES];
 var QUERY_SYMBOLS = {
   // Represents a sub query.
   QUERY: "__RONIN_QUERY",
@@ -24,6 +32,8 @@ var CURRENT_TIME_EXPRESSION = {
   [QUERY_SYMBOLS.EXPRESSION]: `strftime('%Y-%m-%dT%H:%M:%f', 'now') || 'Z'`
 };
 var MOUNTING_PATH_SUFFIX = /(.*?)(\{(\d+)\})?$/;
+
+// src/utils/helpers.ts
 var composeMountingPath = (single, key, mountingPath) => {
   if (key === "ronin_root") {
     return mountingPath ? mountingPath.replace(
@@ -1192,7 +1202,7 @@ var compileQueryInput = (defaultQuery, models, statementParams, options) => {
   if (queryType === "get" && !isJoiningMultipleRows && (single || instructions?.limitedTo)) {
     statement += handleLimitedTo(single, instructions?.limitedTo);
   }
-  if (["add", "set", "remove"].includes(queryType) && returning) {
+  if (DML_QUERY_TYPES_WRITE.includes(queryType) && returning) {
     statement += `RETURNING ${columns}`;
   }
   const mainStatement = {
@@ -2367,7 +2377,12 @@ var Transaction = class {
 };
 var CLEAN_ROOT_MODEL = omit(ROOT_MODEL, ["system"]);
 export {
+  DDL_QUERY_TYPES,
+  DML_QUERY_TYPES,
+  DML_QUERY_TYPES_READ,
+  DML_QUERY_TYPES_WRITE,
   QUERY_SYMBOLS,
+  QUERY_TYPES,
   CLEAN_ROOT_MODEL as ROOT_MODEL,
   RoninError,
   Transaction,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ronin/compiler",
-  "version": "0.17.13",
+  "version": "0.17.14-leo-ron-1113-experimental-405",
   "type": "module",
   "description": "Compiles RONIN queries to SQL statements.",
   "publishConfig": {