@timeback/core 0.1.7-beta.20260223234236 → 0.1.7-beta.20260224173034

package/dist/index.js

@@ -1891,6 +1891,11 @@ class InputValidationError extends ApiError {
 function createInputValidationError(message, issues) {
   return new InputValidationError(message, issues);
 }
+function isApiError(error) {
+  if (!(error instanceof Error))
+    return false;
+  return "statusCode" in error && "response" in error;
+}
 var MAX_RETRIES = 3;
 var RETRY_STATUS_CODES = [429, 503];
 var INITIAL_RETRY_DELAY_MS = 1000;
@@ -1930,6 +1935,17 @@ class BaseTransport {
     const response = await this.requestRaw(path, options);
     return this.handleResponse(response);
   }
+  async exists(path, options = {}) {
+    try {
+      await this.requestRaw(path, options);
+      return true;
+    } catch (error) {
+      if (isApiError(error) && error.statusCode === 404) {
+        return false;
+      }
+      throw error;
+    }
+  }
   async requestRaw(path, options = {}) {
     const { method = "GET", params, body, headers = {} } = options;
     const url = this.buildUrl(path, params);
@@ -19255,6 +19271,11 @@ class InputValidationError2 extends ApiError2 {
 function createInputValidationError2(message, issues) {
   return new InputValidationError2(message, issues);
 }
+function isApiError2(error48) {
+  if (!(error48 instanceof Error))
+    return false;
+  return "statusCode" in error48 && "response" in error48;
+}
 var MAX_RETRIES2 = 3;
 var RETRY_STATUS_CODES2 = [429, 503];
 var INITIAL_RETRY_DELAY_MS2 = 1000;
@@ -19294,6 +19315,17 @@ class BaseTransport2 {
     const response = await this.requestRaw(path, options);
     return this.handleResponse(response);
   }
+  async exists(path, options = {}) {
+    try {
+      await this.requestRaw(path, options);
+      return true;
+    } catch (error48) {
+      if (isApiError2(error48) && error48.statusCode === 404) {
+        return false;
+      }
+      throw error48;
+    }
+  }
   async requestRaw(path, options = {}) {
     const { method = "GET", params, body, headers = {} } = options;
     const url2 = this.buildUrl(path, params);
@@ -34697,6 +34729,17 @@ class PackagesResource {
       headers: { "Content-Type": "application/json" }
     });
   }
+  async upsert(sourcedId, input) {
+    validateNonEmptyString2(sourcedId, "sourcedId");
+    try {
+      return await this.update(sourcedId, input);
+    } catch (error482) {
+      if (isApiError2(error482) && error482.statusCode === 404) {
+        return await this.create(input);
+      }
+      throw error482;
+    }
+  }
   get(sourcedId) {
     validateNonEmptyString2(sourcedId, "sourcedId");
     return this.transport.request(`${this.transport.paths.base}/CFPackages/${encodeURIComponent(sourcedId)}`);
@@ -36228,6 +36271,11 @@ class InputValidationError3 extends ApiError3 {
 function createInputValidationError3(message, issues) {
   return new InputValidationError3(message, issues);
 }
+function isApiError3(error50) {
+  if (!(error50 instanceof Error))
+    return false;
+  return "statusCode" in error50 && "response" in error50;
+}
 var MAX_RETRIES3 = 3;
 var RETRY_STATUS_CODES3 = [429, 503];
 var INITIAL_RETRY_DELAY_MS3 = 1000;
@@ -36267,6 +36315,17 @@ class BaseTransport3 {
     const response = await this.requestRaw(path, options);
     return this.handleResponse(response);
   }
+  async exists(path, options = {}) {
+    try {
+      await this.requestRaw(path, options);
+      return true;
+    } catch (error50) {
+      if (isApiError3(error50) && error50.statusCode === 404) {
+        return false;
+      }
+      throw error50;
+    }
+  }
   async requestRaw(path, options = {}) {
     const { method = "GET", params, body, headers = {} } = options;
     const url3 = this.buildUrl(path, params);
@@ -53120,6 +53179,11 @@ class InputValidationError4 extends ApiError4 {
 function createInputValidationError4(message, issues) {
   return new InputValidationError4(message, issues);
 }
+function isApiError4(error51) {
+  if (!(error51 instanceof Error))
+    return false;
+  return "statusCode" in error51 && "response" in error51;
+}
 var MAX_RETRIES4 = 3;
 var RETRY_STATUS_CODES4 = [429, 503];
 var INITIAL_RETRY_DELAY_MS4 = 1000;
@@ -53159,6 +53223,17 @@ class BaseTransport4 {
     const response = await this.requestRaw(path, options);
     return this.handleResponse(response);
   }
+  async exists(path, options = {}) {
+    try {
+      await this.requestRaw(path, options);
+      return true;
+    } catch (error51) {
+      if (isApiError4(error51) && error51.statusCode === 404) {
+        return false;
+      }
+      throw error51;
+    }
+  }
   async requestRaw(path, options = {}) {
     const { method = "GET", params, body, headers = {} } = options;
     const url4 = this.buildUrl(path, params);
@@ -69869,7 +69944,7 @@ class ValidationError5 extends ApiError5 {
     super(message, 422, response);
   }
 }
-function isApiError(error55) {
+function isApiError5(error55) {
   if (!(error55 instanceof Error))
     return false;
   return "statusCode" in error55 && "response" in error55;
@@ -71417,6 +71492,11 @@ class InputValidationError6 extends ApiError6 {
 function createInputValidationError6(message, issues) {
   return new InputValidationError6(message, issues);
 }
+function isApiError6(error55) {
+  if (!(error55 instanceof Error))
+    return false;
+  return "statusCode" in error55 && "response" in error55;
+}
 var MAX_RETRIES6 = 3;
 var RETRY_STATUS_CODES6 = [429, 503];
 var INITIAL_RETRY_DELAY_MS6 = 1000;
@@ -71456,6 +71536,17 @@ class BaseTransport6 {
     const response = await this.requestRaw(path, options);
     return this.handleResponse(response);
   }
+  async exists(path, options = {}) {
+    try {
+      await this.requestRaw(path, options);
+      return true;
+    } catch (error55) {
+      if (isApiError6(error55) && error55.statusCode === 404) {
+        return false;
+      }
+      throw error55;
+    }
+  }
   async requestRaw(path, options = {}) {
     const { method = "GET", params, body, headers = {} } = options;
     const url5 = this.buildUrl(path, params);
@@ -87098,6 +87189,10 @@ class BaseResource {
     const response = await this.transport.request(`${this.basePath}/${sourcedId}`);
     return this.unwrapSingle(response);
   }
+  exists(sourcedId) {
+    validateSourcedId2(sourcedId, `exists ${this.resourceName}`);
+    return this.transport.exists(`${this.basePath}/${sourcedId}`);
+  }
   create(data) {
     const schema = this.createSchema;
     if (schema) {
@@ -87111,6 +87206,23 @@ class BaseResource {
   }
   async update(sourcedId, data) {
     validateSourcedId2(sourcedId, `update ${this.resourceName}`);
+    await this.ensureExistsForUpdate(sourcedId);
+    return this.sendUpdate(sourcedId, data);
+  }
+  async upsert(sourcedId, data) {
+    validateSourcedId2(sourcedId, `upsert ${this.resourceName}`);
+    const fullData = { ...data, sourcedId };
+    try {
+      return await this.sendUpdate(sourcedId, fullData);
+    } catch (error482) {
+      if (isApiError6(error482) && error482.statusCode === 404) {
+        await this.create(fullData);
+        return;
+      }
+      throw error482;
+    }
+  }
+  async sendUpdate(sourcedId, data) {
     const schema = this.updateSchema;
     if (schema) {
       validateWithSchema6(schema, data, `update ${this.resourceName}`);
@@ -87120,6 +87232,28 @@ class BaseResource {
       method: "PUT",
       body
     });
+    return;
+  }
+  async sendUpdateAndReturn(sourcedId, data) {
+    const schema = this.updateSchema;
+    if (schema) {
+      validateWithSchema6(schema, data, `update ${this.resourceName}`);
+    }
+    const body = this.wrapBody(data);
+    const response = await this.transport.request(`${this.basePath}/${sourcedId}`, {
+      method: "PUT",
+      body
+    });
+    return this.unwrapSingle(response);
+  }
+  async ensureExistsForUpdate(sourcedId) {
+    if (!this.serverNativelyUpserts) {
+      return;
+    }
+    const found = await this.exists(sourcedId);
+    if (!found) {
+      throw new NotFoundError6(`${this.resourceName} '${sourcedId}' not found`);
+    }
   }
   async delete(sourcedId) {
     validateSourcedId2(sourcedId, `delete ${this.resourceName}`);
@@ -87139,6 +87273,9 @@ class BaseResource {
   get patchSchema() {
     return;
   }
+  get serverNativelyUpserts() {
+    return false;
+  }
   get resourceName() {
     return this.wrapKey;
   }
@@ -87186,6 +87323,10 @@ class ReadOnlyResource {
     }
     return this.transform(data);
   }
+  exists(sourcedId) {
+    validateSourcedId2(sourcedId, `exists ${this.wrapKey}`);
+    return this.transport.exists(`${this.basePath}/${sourcedId}`);
+  }
   transform(entity) {
     return entity;
   }
@@ -87203,6 +87344,9 @@ class ScopedAssessmentLineItemResource {
     const response = await this.transport.request(this.basePath);
     return response.assessmentLineItem;
   }
+  exists() {
+    return this.transport.exists(this.basePath);
+  }
 }
 
 class AssessmentLineItemsResourceImpl extends BaseResource {
@@ -87228,6 +87372,30 @@ class AssessmentLineItemsResourceImpl extends BaseResource {
   get updateSchema() {
     return OneRosterAssessmentLineItemCreateInput5;
   }
+  get serverNativelyUpserts() {
+    return true;
+  }
+  async update(sourcedId, data) {
+    validateSourcedId2(sourcedId, "update assessment line item");
+    await this.ensureExistsForUpdate(sourcedId);
+    return this.sendUpdateAndReturn(sourcedId, data);
+  }
+  async upsert(sourcedId, data) {
+    validateSourcedId2(sourcedId, "upsert assessment line item");
+    const fullData = {
+      ...data,
+      sourcedId
+    };
+    try {
+      return await this.sendUpdateAndReturn(sourcedId, fullData);
+    } catch (error482) {
+      if (isApiError6(error482) && error482.statusCode === 404) {
+        await this.create(fullData);
+        return this.get(sourcedId);
+      }
+      throw error482;
+    }
+  }
 }
 function createAssessmentLineItemsResource(transport) {
   const impl = new AssessmentLineItemsResourceImpl(transport);
@@ -87237,8 +87405,10 @@ function createAssessmentLineItemsResource(transport) {
   callable.first = impl.first.bind(impl);
   callable.stream = impl.stream.bind(impl);
   callable.get = impl.get.bind(impl);
+  callable.exists = impl.exists.bind(impl);
   callable.create = impl.create.bind(impl);
   callable.update = impl.update.bind(impl);
+  callable.upsert = impl.upsert.bind(impl);
   callable.patch = impl.patch.bind(impl);
   callable.delete = impl.delete.bind(impl);
   return callable;
@@ -87267,6 +87437,30 @@ class AssessmentResultsResource extends BaseResource {
   get updateSchema() {
     return OneRosterAssessmentResultCreateInput5;
   }
+  get serverNativelyUpserts() {
+    return true;
+  }
+  async update(sourcedId, data) {
+    validateSourcedId2(sourcedId, "update assessment result");
+    await this.ensureExistsForUpdate(sourcedId);
+    return this.sendUpdateAndReturn(sourcedId, data);
+  }
+  async upsert(sourcedId, data) {
+    validateSourcedId2(sourcedId, "upsert assessment result");
+    const fullData = {
+      ...data,
+      sourcedId
+    };
+    try {
+      return await this.sendUpdateAndReturn(sourcedId, fullData);
+    } catch (error482) {
+      if (isApiError6(error482) && error482.statusCode === 404) {
+        await this.create(fullData);
+        return this.get(sourcedId);
+      }
+      throw error482;
+    }
+  }
 }
 
 class ScopedLineItemResource {
@@ -87281,6 +87475,9 @@ class ScopedLineItemResource {
     const response = await this.transport.request(this.basePath);
     return response.lineItem;
   }
+  exists() {
+    return this.transport.exists(this.basePath);
+  }
   createResults(results) {
     validateWithSchema6(OneRosterBulkResultsInput5, results, "bulk results");
     return this.transport.request(`${this.basePath}/results`, {
@@ -87309,6 +87506,27 @@ class LineItemsResourceImpl extends BaseResource {
   get updateSchema() {
     return OneRosterLineItemCreateInput5;
   }
+  get serverNativelyUpserts() {
+    return true;
+  }
+  async update(sourcedId, data) {
+    validateSourcedId2(sourcedId, "update line item");
+    await this.ensureExistsForUpdate(sourcedId);
+    return this.sendUpdateAndReturn(sourcedId, data);
+  }
+  async upsert(sourcedId, data) {
+    validateSourcedId2(sourcedId, "upsert line item");
+    const fullData = { ...data, sourcedId };
+    try {
+      return await this.sendUpdateAndReturn(sourcedId, fullData);
+    } catch (error482) {
+      if (isApiError6(error482) && error482.statusCode === 404) {
+        await this.create(fullData);
+        return this.get(sourcedId);
+      }
+      throw error482;
+    }
+  }
 }
 function createLineItemsResource(transport) {
   const impl = new LineItemsResourceImpl(transport);
@@ -87318,8 +87536,10 @@ function createLineItemsResource(transport) {
   callable.first = impl.first.bind(impl);
   callable.stream = impl.stream.bind(impl);
   callable.get = impl.get.bind(impl);
+  callable.exists = impl.exists.bind(impl);
   callable.create = impl.create.bind(impl);
   callable.update = impl.update.bind(impl);
+  callable.upsert = impl.upsert.bind(impl);
   callable.delete = impl.delete.bind(impl);
   return callable;
 }
@@ -87343,6 +87563,27 @@ class ResultsResource extends BaseResource {
   get updateSchema() {
     return OneRosterResultCreateInput5;
   }
+  get serverNativelyUpserts() {
+    return true;
+  }
+  async update(sourcedId, data) {
+    validateSourcedId2(sourcedId, "update result");
+    await this.ensureExistsForUpdate(sourcedId);
+    return this.sendUpdateAndReturn(sourcedId, data);
+  }
+  async upsert(sourcedId, data) {
+    validateSourcedId2(sourcedId, "upsert result");
+    const fullData = { ...data, sourcedId };
+    try {
+      return await this.sendUpdateAndReturn(sourcedId, fullData);
+    } catch (error482) {
+      if (isApiError6(error482) && error482.statusCode === 404) {
+        await this.create(fullData);
+        return this.get(sourcedId);
+      }
+      throw error482;
+    }
+  }
 }
 
 class CategoriesResource extends BaseResource {
@@ -87361,6 +87602,27 @@ class CategoriesResource extends BaseResource {
   get updateSchema() {
     return OneRosterCategoryCreateInput5;
   }
+  get serverNativelyUpserts() {
+    return true;
+  }
+  async update(sourcedId, data) {
+    validateSourcedId2(sourcedId, "update category");
+    await this.ensureExistsForUpdate(sourcedId);
+    return this.sendUpdateAndReturn(sourcedId, data);
+  }
+  async upsert(sourcedId, data) {
+    validateSourcedId2(sourcedId, "upsert category");
+    const fullData = { ...data, sourcedId };
+    try {
+      return await this.sendUpdateAndReturn(sourcedId, fullData);
+    } catch (error482) {
+      if (isApiError6(error482) && error482.statusCode === 404) {
+        await this.create(fullData);
+        return this.get(sourcedId);
+      }
+      throw error482;
+    }
+  }
 }
 
 class ScoreScalesResource extends BaseResource {
@@ -87379,6 +87641,30 @@ class ScoreScalesResource extends BaseResource {
   get updateSchema() {
     return OneRosterScoreScaleCreateInput5;
   }
+  get serverNativelyUpserts() {
+    return true;
+  }
+  async update(sourcedId, data) {
+    validateSourcedId2(sourcedId, "update score scale");
+    await this.ensureExistsForUpdate(sourcedId);
+    return this.sendUpdateAndReturn(sourcedId, data);
+  }
+  async upsert(sourcedId, data) {
+    validateSourcedId2(sourcedId, "upsert score scale");
+    const fullData = {
+      ...data,
+      sourcedId
+    };
+    try {
+      return await this.sendUpdateAndReturn(sourcedId, fullData);
+    } catch (error482) {
+      if (isApiError6(error482) && error482.statusCode === 404) {
+        await this.create(fullData);
+        return this.get(sourcedId);
+      }
+      throw error482;
+    }
+  }
 }
 
 class ScopedResourceResource {
@@ -87395,6 +87681,9 @@ class ScopedResourceResource {
     const response = await this.transport.request(this.basePath);
     return response.resource;
   }
+  exists() {
+    return this.transport.exists(this.basePath);
+  }
   async export() {
     const response = await this.transport.requestRaw(`${this.transport.paths.resources}/resources/export/${this.resourceId}`, {
       method: "POST",
@@ -87437,8 +87726,10 @@ function createResourcesResource(transport) {
   callable.first = impl.first.bind(impl);
   callable.stream = impl.stream.bind(impl);
   callable.get = impl.get.bind(impl);
+  callable.exists = impl.exists.bind(impl);
   callable.create = impl.create.bind(impl);
   callable.update = impl.update.bind(impl);
+  callable.upsert = impl.upsert.bind(impl);
   callable.delete = impl.delete.bind(impl);
   callable.export = impl.export.bind(impl);
   return callable;
@@ -87462,6 +87753,9 @@ class ScopedUserResource {
       grades: parseGrades(response.user.grades)
     };
   }
+  exists() {
+    return this.transport.exists(this.basePath);
+  }
   async demographics() {
     const response = await this.transport.request(`${this.basePath}/demographics`);
     return {
@@ -87553,8 +87847,10 @@ function createUsersResource(transport) {
   callable.first = impl.first.bind(impl);
   callable.stream = impl.stream.bind(impl);
   callable.get = impl.get.bind(impl);
+  callable.exists = impl.exists.bind(impl);
   callable.create = impl.create.bind(impl);
   callable.update = impl.update.bind(impl);
+  callable.upsert = impl.upsert.bind(impl);
   callable.delete = impl.delete.bind(impl);
   return callable;
 }
@@ -87575,6 +87871,9 @@ class ScopedStudentResource {
       grades: parseGrades(response.user.grades)
     };
   }
+  exists() {
+    return this.transport.exists(this.basePath);
+  }
   classes(params) {
     return this.streamClasses(params).toArray();
   }
@@ -87599,6 +87898,9 @@ class ScopedTeacherResource {
       grades: parseGrades(response.user.grades)
     };
   }
+  exists() {
+    return this.transport.exists(this.basePath);
+  }
   classes(params) {
     return this.streamClasses(params).toArray();
   }
@@ -87633,6 +87935,7 @@ function createStudentsResource(transport) {
   callable.first = impl.first.bind(impl);
   callable.stream = impl.stream.bind(impl);
   callable.get = impl.get.bind(impl);
+  callable.exists = impl.exists.bind(impl);
   return callable;
 }
 
@@ -87662,6 +87965,7 @@ function createTeachersResource(transport) {
   callable.first = impl.first.bind(impl);
   callable.stream = impl.stream.bind(impl);
   callable.get = impl.get.bind(impl);
+  callable.exists = impl.exists.bind(impl);
   return callable;
 }
 
@@ -87728,6 +88032,9 @@ class ScopedSchoolResource {
     const response = await this.transport.request(this.basePath);
     return response.org;
   }
+  exists() {
+    return this.transport.exists(this.basePath);
+  }
   class(classId) {
     return new ScopedSchoolClassResource(this.transport, this.schoolId, classId);
   }
@@ -87817,8 +88124,10 @@ function createSchoolsResource(transport) {
   callable.first = impl.first.bind(impl);
   callable.stream = impl.stream.bind(impl);
   callable.get = impl.get.bind(impl);
+  callable.exists = impl.exists.bind(impl);
   callable.create = impl.create.bind(impl);
   callable.update = impl.update.bind(impl);
+  callable.upsert = impl.upsert.bind(impl);
   callable.delete = impl.delete.bind(impl);
   return callable;
 }
@@ -87891,6 +88200,9 @@ class ScopedClassResource {
     const response = await this.transport.request(this.rosteringPath);
     return response.class;
   }
+  exists() {
+    return this.transport.exists(this.rosteringPath);
+  }
   students(params) {
     return this.streamStudents(params).toArray();
   }
@@ -88000,8 +88312,10 @@ function createClassesResource(transport) {
   callable.first = impl.first.bind(impl);
   callable.stream = impl.stream.bind(impl);
   callable.get = impl.get.bind(impl);
+  callable.exists = impl.exists.bind(impl);
   callable.create = impl.create.bind(impl);
   callable.update = impl.update.bind(impl);
+  callable.upsert = impl.upsert.bind(impl);
   callable.delete = impl.delete.bind(impl);
   return callable;
 }
@@ -88020,6 +88334,9 @@ class ScopedCourseResource {
     const response = await this.transport.request(this.basePath);
     return response.course;
   }
+  exists() {
+    return this.transport.exists(this.basePath);
+  }
   classes(params) {
     return this.streamClasses(params).toArray();
   }
@@ -88150,8 +88467,10 @@ function createCoursesResource(transport) {
   callable.first = impl.first.bind(impl);
   callable.stream = impl.stream.bind(impl);
   callable.get = impl.get.bind(impl);
+  callable.exists = impl.exists.bind(impl);
   callable.create = impl.create.bind(impl);
   callable.update = impl.update.bind(impl);
+  callable.upsert = impl.upsert.bind(impl);
   callable.delete = impl.delete.bind(impl);
   callable.components = impl.components.bind(impl);
   callable.streamComponents = impl.streamComponents.bind(impl);
@@ -88236,6 +88555,9 @@ class ScopedTermResource {
     const response = await this.transport.request(this.basePath);
     return response.term;
   }
+  exists() {
+    return this.transport.exists(this.basePath);
+  }
   classes(params) {
     return this.streamClasses(params).toArray();
   }
@@ -88288,6 +88610,7 @@ function createTermsResource(transport) {
   callable.first = impl.first.bind(impl);
   callable.stream = impl.stream.bind(impl);
   callable.get = impl.get.bind(impl);
+  callable.exists = impl.exists.bind(impl);
   return callable;
 }
 
@@ -89888,6 +90211,11 @@ class InputValidationError7 extends ApiError7 {
 function createInputValidationError7(message, issues) {
   return new InputValidationError7(message, issues);
 }
+function isApiError7(error57) {
+  if (!(error57 instanceof Error))
+    return false;
+  return "statusCode" in error57 && "response" in error57;
+}
 var MAX_RETRIES7 = 3;
 var RETRY_STATUS_CODES7 = [429, 503];
 var INITIAL_RETRY_DELAY_MS7 = 1000;
@@ -89927,6 +90255,17 @@ class BaseTransport7 {
     const response = await this.requestRaw(path, options);
     return this.handleResponse(response);
   }
+  async exists(path, options = {}) {
+    try {
+      await this.requestRaw(path, options);
+      return true;
+    } catch (error57) {
+      if (isApiError7(error57) && error57.statusCode === 404) {
+        return false;
+      }
+      throw error57;
+    }
+  }
   async requestRaw(path, options = {}) {
     const { method = "GET", params, body, headers = {} } = options;
     const url6 = this.buildUrl(path, params);
@@ -107326,6 +107665,11 @@ class InputValidationError8 extends ApiError8 {
 function createInputValidationError8(message, issues) {
   return new InputValidationError8(message, issues);
 }
+function isApiError8(error59) {
+  if (!(error59 instanceof Error))
+    return false;
+  return "statusCode" in error59 && "response" in error59;
+}
 var MAX_RETRIES8 = 3;
 var RETRY_STATUS_CODES8 = [429, 503];
 var INITIAL_RETRY_DELAY_MS8 = 1000;
@@ -107365,6 +107709,17 @@ class BaseTransport8 {
     const response = await this.requestRaw(path, options);
     return this.handleResponse(response);
   }
+  async exists(path, options = {}) {
+    try {
+      await this.requestRaw(path, options);
+      return true;
+    } catch (error59) {
+      if (isApiError8(error59) && error59.statusCode === 404) {
+        return false;
+      }
+      throw error59;
+    }
+  }
   async requestRaw(path, options = {}) {
     const { method = "GET", params, body, headers = {} } = options;
     const url7 = this.buildUrl(path, params);
@@ -122985,6 +123340,21 @@ class AssessmentItemsResource {
       body
     });
   }
+  async upsert(identifier, body) {
+    validateNonEmptyString6(identifier, "identifier");
+    try {
+      return await this.update(identifier, body);
+    } catch (error482) {
+      if (isApiError8(error482) && error482.statusCode === 404) {
+        const { rawXml: _, content: _c, ...createBody } = body;
+        return await this.create({
+          ...createBody,
+          identifier
+        });
+      }
+      throw error482;
+    }
+  }
   delete(identifier) {
     validateNonEmptyString6(identifier, "identifier");
     return this.transport.request(`/assessment-items/${encodeURIComponent(identifier)}`, {
@@ -123214,6 +123584,17 @@ class AssessmentTestsResource {
       body
     });
   }
+  async upsert(identifier, body) {
+    validateNonEmptyString6(identifier, "identifier");
+    try {
+      return await this.update(identifier, body);
+    } catch (error482) {
+      if (isApiError8(error482) && error482.statusCode === 404) {
+        return await this.create({ ...body, identifier });
+      }
+      throw error482;
+    }
+  }
   delete(identifier) {
     validateNonEmptyString6(identifier, "identifier");
     return this.transport.request(`/assessment-tests/${encodeURIComponent(identifier)}`, {
@@ -123319,6 +123700,17 @@ class StimuliResource {
       body
     });
   }
+  async upsert(identifier, body) {
+    validateNonEmptyString6(identifier, "identifier");
+    try {
+      return await this.update(identifier, body);
+    } catch (error482) {
+      if (isApiError8(error482) && error482.statusCode === 404) {
+        return await this.create({ ...body, identifier });
+      }
+      throw error482;
+    }
+  }
   delete(identifier) {
     validateNonEmptyString6(identifier, "identifier");
     return this.transport.request(`/stimuli/${encodeURIComponent(identifier)}`, {
@@ -124872,6 +125264,11 @@ class InputValidationError9 extends ApiError9 {
 function createInputValidationError9(message, issues) {
   return new InputValidationError9(message, issues);
 }
+function isApiError9(error60) {
+  if (!(error60 instanceof Error))
+    return false;
+  return "statusCode" in error60 && "response" in error60;
+}
 var MAX_RETRIES9 = 3;
 var RETRY_STATUS_CODES9 = [429, 503];
 var INITIAL_RETRY_DELAY_MS9 = 1000;
@@ -124911,6 +125308,17 @@ class BaseTransport9 {
     const response = await this.requestRaw(path, options);
     return this.handleResponse(response);
   }
+  async exists(path, options = {}) {
+    try {
+      await this.requestRaw(path, options);
+      return true;
+    } catch (error60) {
+      if (isApiError9(error60) && error60.statusCode === 404) {
+        return false;
+      }
+      throw error60;
+    }
+  }
   async requestRaw(path, options = {}) {
     const { method = "GET", params, body, headers = {} } = options;
     const url8 = this.buildUrl(path, params);
@@ -140643,7 +141051,7 @@ class TimebackManager {
 }
 export {
   whereToFilter2 as whereToFilter,
-  isApiError,
+  isApiError5 as isApiError,
   getServiceUrlsForEnv,
   ValidationError5 as ValidationError,
   UnauthorizedError5 as UnauthorizedError,

package/dist/utils.js

@@ -1481,6 +1481,11 @@ class InputValidationError extends ApiError {
 function createInputValidationError(message, issues) {
   return new InputValidationError(message, issues);
 }
+function isApiError(error) {
+  if (!(error instanceof Error))
+    return false;
+  return "statusCode" in error && "response" in error;
+}
 var MAX_RETRIES = 3;
 var RETRY_STATUS_CODES = [429, 503];
 var INITIAL_RETRY_DELAY_MS = 1000;
@@ -1520,6 +1525,17 @@ class BaseTransport {
     const response = await this.requestRaw(path, options);
     return this.handleResponse(response);
   }
+  async exists(path, options = {}) {
+    try {
+      await this.requestRaw(path, options);
+      return true;
+    } catch (error) {
+      if (isApiError(error) && error.statusCode === 404) {
+        return false;
+      }
+      throw error;
+    }
+  }
   async requestRaw(path, options = {}) {
     const { method = "GET", params, body, headers = {} } = options;
     const url = this.buildUrl(path, params);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timeback/core",
-	"version": "0.1.7-beta.20260223234236",
+	"version": "0.1.7-beta.20260224173034",
 	"type": "module",
 	"exports": {
 		".": {