feat(clients): add missing guides

scripts/ci/codegen/pushToRepository.ts

@@ -20,6 +20,7 @@ import { pushToRepositoryConfiguration } from './types.ts';
 
 import { getClientsConfigField } from '../../config.ts';
 import { commitStartRelease } from './text.ts';
+import { sleep } from './waitForAllReleases.ts';
 
 async function handleSpecFiles(spec: SpecsToPush, tempGitDir: string): Promise<void> {
   const pathToSpecs = toAbsolutePath(`${tempGitDir}/${spec.output}`);
@@ -158,6 +159,9 @@ async function pushToRepository(repository: string, config: RepositoryConfigurat
       head: task.prBranch,
     });
 
+    // the graphql api of gh might have some cache so we need to wait a bit
+    await sleep(10_000);
+
     await run(`gh pr merge ${data.number} --auto`);
 
     console.log(`Pull request created on ${OWNER}/${repository}`);

scripts/ci/codegen/waitForAllReleases.ts

@@ -44,7 +44,7 @@ async function fetchAllRuns(runs: Run[]): Promise<void> {
   );
 }
 
-function sleep(ms: number): Promise<void> {
+export function sleep(ms: number): Promise<void> {
   return new Promise((resolve) => {
     setTimeout(resolve, ms);
   });

templates/csharp/guides/search/searchFuturePublishedBooks.mustache

@@ -0,0 +1,30 @@
+namespace Algolia;
+
+using System;
+using System.Text.Json;
+using System.Net.Http;
+using System.Collections.Generic;
+
+{{> snippets/import}}
+
+class SearchFuturePublishedBooks {
+
+  async Task Main(string[] args)
+  {
+
+    try {
+      {{> snippets/init}}
+      var dateTimestamp = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
+      var searchParams = new SearchParams(new SearchParamsObject
+          {
+              Query = "<YOUR_SEARCH_QUERY>",
+              Filters = $"date_timestamp > {dateTimestamp}"
+          }
+      );
+
+      {{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}};
+    } catch (Exception e) {
+      Console.WriteLine(e.Message);
+    }
+  }
+}

templates/csharp/guides/search/searchRecentlyPublishedBooks.mustache

@@ -14,11 +14,13 @@ class SearchRecentlyPublishedBooks {
 
     try {
       {{> snippets/init}}
-      var dateTimestamp = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
+      var date = DateTime.UtcNow.AddYears(-1);
+      var sTime = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
+      var unixTime = (long)(date - sTime).TotalSeconds;
       var searchParams = new SearchParams(new SearchParamsObject
           {
               Query = "<YOUR_SEARCH_QUERY>",
-              Filters = $"date_timestamp > {dateTimestamp}"
+              Filters = $"date_timestamp > {unixTime}"
           }
       );
 

templates/dart/guides/search/searchFuturePublishedBooks.mustache

@@ -0,0 +1,13 @@
+{{> snippets/import}}
+
+void searchFuturePublishedBooks() async {
+  {{> snippets/init}}
+
+  final dateTimestamp = DateTime.now().millisecondsSinceEpoch;
+  final searchParams = SearchParamsObject(
+      query: "<YOUR_SEARCH_QUERY>",
+      filters: "date_timestamp > $dateTimestamp"
+  );
+
+  await {{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}};
+}

templates/dart/guides/search/searchRecentlyPublishedBooks.mustache

@@ -3,7 +3,7 @@
 void searchRecentlyPublishedBooks() async {
   {{> snippets/init}}
 
-  final dateTimestamp = DateTime.now().millisecondsSinceEpoch;
+  final dateTimestamp = DateTime.now().subtract(Duration(days: 365)).millisecondsSinceEpoch;
   final searchParams = SearchParamsObject(
       query: "<YOUR_SEARCH_QUERY>",
       filters: "date_timestamp > $dateTimestamp"

templates/go/guides/search/searchFuturePublishedBooks.mustache

@@ -0,0 +1,26 @@
+package main
+
+import (
+  "encoding/json"
+  "fmt"
+  "net/http"
+  "time"
+)
+
+{{> snippets/import}}
+
+func searchFuturePublishedBooks() {
+  {{> snippets/init}}
+
+  dateTimestamp := time.Now().UnixMilli()
+  searchParams := search.SearchParamsObjectAsSearchParams(
+    search.NewSearchParamsObject().
+      SetQuery("<YOUR_SEARCH_QUERY>").
+      SetFilters(fmt.Sprintf("date_timestamp > %d", dateTimestamp)),
+  )
+
+  _, err = {{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}}
+  if err != nil {
+    panic(err)
+  }
+}

templates/go/guides/search/searchRecentlyPublishedBooks.mustache

@@ -12,7 +12,7 @@ import (
 func searchRecentlyPublishedBooks() {
   {{> snippets/init}}
 
-  dateTimestamp := time.Now().UnixMilli()
+  dateTimestamp := time.Now().AddDate(-1, 0, 0).Unix()
   searchParams := search.SearchParamsObjectAsSearchParams(
     search.NewSearchParamsObject().
       SetQuery("<YOUR_SEARCH_QUERY>").

templates/java/guides/search/searchFuturePublishedBooks.mustache

@@ -0,0 +1,20 @@
+package com.algolia;
+
+{{> snippets/import}}
+
+public class searchFuturePublishedBooks {
+
+  public static void main(String[] args) throws Exception {
+
+    try ({{> snippets/init}}) {
+      long dateTimestamp = System.currentTimeMillis();
+      SearchParams searchParams = new SearchParamsObject()
+        .setQuery("<YOUR_SEARCH_QUERY>")
+        .setFilters("date_timestamp > " + dateTimestamp);
+
+      {{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}};
+    } catch (Exception e) {
+      System.out.println("An error occurred: " + e.getMessage());
+    }
+  }
+}

templates/java/guides/search/searchRecentlyPublishedBooks.mustache

@@ -1,13 +1,16 @@
 package com.algolia;
 
+import java.time.ZoneOffset;
+import java.time.ZonedDateTime;
+
 {{> snippets/import}}
 
 public class searchRecentlyPublishedBooks {
 
   public static void main(String[] args) throws Exception {
 
     try ({{> snippets/init}}) {
-      long dateTimestamp = System.currentTimeMillis();
+      long dateTimestamp = ZonedDateTime.now(ZoneOffset.UTC).plusYears(-1).toEpochSecond();
       SearchParams searchParams = new SearchParamsObject()
         .setQuery("<YOUR_SEARCH_QUERY>")
         .setFilters("date_timestamp > " + dateTimestamp);

templates/javascript/guides/search/searchFuturePublishedBooks.mustache

@@ -0,0 +1,16 @@
+{{> snippets/import}}
+import type { SearchParams } from 'algoliasearch';
+
+try {
+  {{> snippets/init}}
+
+  const dateTimestamp = Date.now();
+  const searchParams: SearchParams = {
+    query: "<YOUR_SEARCH_QUERY>",
+    filters: `date_timestamp > ${dateTimestamp}`
+  };
+
+  {{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}}
+} catch (e: any) {
+  console.error(e);
+}

templates/javascript/guides/search/searchRecentlyPublishedBooks.mustache

@@ -4,10 +4,10 @@ import type { SearchParams } from 'algoliasearch';
 try {
   {{> snippets/init}}
 
-  const dateTimestamp = Date.now();
+  const d = new Date();
   const searchParams: SearchParams = {
     query: "<YOUR_SEARCH_QUERY>",
-    filters: `date_timestamp > ${dateTimestamp}`
+    filters: `date_timestamp > ${Math.floor(d.setDate(d.getDate() - 365) / 1000)}`
   };
 
   {{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}}

templates/kotlin/guides/search/searchFuturePublishedBooks.mustache

@@ -0,0 +1,16 @@
+import java.time.Instant
+
+{{> snippets/import}}
+import com.algolia.client.model.search.*
+
+suspend fun searchFuturePublishedBooks() {
+  {{> snippets/init}}
+
+  val dateTimestamp = Instant.now().epochSecond
+  val searchParams = SearchParamsObject(
+    query = "<YOUR_SEARCH_QUERY>",
+    filters = "date_timestamp > $dateTimestamp"
+  )
+
+  client.{{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}}
+}

templates/kotlin/guides/search/searchRecentlyPublishedBooks.mustache

@@ -1,12 +1,13 @@
 import java.time.Instant
+import java.time.temporal.ChronoUnit
 
 {{> snippets/import}}
 import com.algolia.client.model.search.*
 
 suspend fun searchRecentlyPublishedBooks() {
   {{> snippets/init}}
 
-  val dateTimestamp = Instant.now().epochSecond
+  val dateTimestamp = Instant.now().minus(365, ChronoUnit.DAYS).epochSecond
   val searchParams = SearchParamsObject(
     query = "<YOUR_SEARCH_QUERY>",
     filters = "date_timestamp > $dateTimestamp"

templates/php/guides/search/searchFuturePublishedBooks.mustache

@@ -0,0 +1,18 @@
+<?php
+
+require __DIR__.'/../vendor/autoload.php';
+{{> snippets/import}}
+use Algolia\AlgoliaSearch\Model\Search\SearchParamsObject;
+
+try {
+  {{> snippets/init}}
+
+  $dateTimestamp = time();
+  $searchParams = (new SearchParamsObject())
+      ->setQuery('<YOUR_SEARCH_QUERY>')
+      ->setFilters("date_timestamp > " . $dateTimestamp);
+
+  {{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}};
+} catch (Exception $e) {
+  echo $e->getMessage() . PHP_EOL;
+}

templates/php/guides/search/searchRecentlyPublishedBooks.mustache

@@ -7,7 +7,7 @@ use Algolia\AlgoliaSearch\Model\Search\SearchParamsObject;
 try {
   {{> snippets/init}}
 
-  $dateTimestamp = time();
+  $dateTimestamp = strtotime('-1 years');
   $searchParams = (new SearchParamsObject())
       ->setQuery('<YOUR_SEARCH_QUERY>')
       ->setFilters("date_timestamp > " . $dateTimestamp);

templates/python/guides/search/searchFuturePublishedBooks.mustache

@@ -0,0 +1,18 @@
+import time
+
+{{> snippets/import}}
+
+
+if __name__ == "__main__":
+  try:
+    _{{> snippets/init}}
+
+    date_timestamp = time.time()  # Get current timestamp
+    search_params = {
+        "query": "<YOUR_SEARCH_QUERY>",
+        "filters": f"date_timestamp > {date_timestamp}"
+    }
+
+    {{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}}
+  except Exception as e:
+    print(f"Error: {e}")

templates/python/guides/search/searchRecentlyPublishedBooks.mustache

@@ -1,3 +1,4 @@
+import datetime
 import time
 
 {{> snippets/import}}
@@ -7,7 +8,8 @@ if __name__ == "__main__":
   try:
     _{{> snippets/init}}
 
-    date_timestamp = time.time()  # Get current timestamp
+    date = datetime.datetime.now() - datetime.timedelta(days=365)
+    date_timestamp = int(time.mktime(date.timetuple()))
     search_params = {
         "query": "<YOUR_SEARCH_QUERY>",
         "filters": f"date_timestamp > {date_timestamp}"

templates/ruby/guides/search/searchFuturePublishedBooks.mustache

@@ -0,0 +1,13 @@
+import time
+
+{{> snippets/import}}
+
+{{> snippets/init}}
+
+date_timestamp = Time.now.to_i # Get current timestamp
+search_params = Algolia::Search::SearchParamsObject.new(
+  query: "<YOUR_SEARCH_QUERY>",
+  filters: "date_timestamp > #{date_timestamp}"
+)
+
+{{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}}

templates/ruby/guides/search/searchRecentlyPublishedBooks.mustache

@@ -4,7 +4,7 @@ import time
 
 {{> snippets/init}}
 
-date_timestamp = Time.now.to_i # Get current timestamp
+date_timestamp = Time.now.to_i - 60 * 60 * 24 * 365
 search_params = Algolia::Search::SearchParamsObject.new(
   query: "<YOUR_SEARCH_QUERY>",
   filters: "date_timestamp > #{date_timestamp}"

templates/scala/guides/search/searchFuturePublishedBooks.mustache

@@ -0,0 +1,23 @@
+import scala.concurrent.ExecutionContext.Implicits.global
+import scala.concurrent.Future
+import java.time.Instant
+
+{{> snippets/import}}
+import algoliasearch.search.SearchParamsObject
+
+def searchFuturePublishedBooks(): Future[Unit] = {
+  {{> snippets/init}}
+
+  val dateTimestamp = Instant.now.getEpochSecond
+  val searchParams = SearchParamsObject(
+    query = Some("<YOUR_SEARCH_QUERY>"),
+    filters = Some(s"date_timestamp > $dateTimestamp")
+  )
+
+  {{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}}.map { response =>
+    println(response)
+  }.recover {
+    case ex: Exception =>
+      println(s"An error occurred: ${ex.getMessage}")
+  }
+}

templates/scala/guides/search/searchRecentlyPublishedBooks.mustache

@@ -1,14 +1,14 @@
 import scala.concurrent.ExecutionContext.Implicits.global
 import scala.concurrent.Future
-import java.time.Instant
+import java.time.{Instant, LocalDateTime, ZoneOffset}
 
 {{> snippets/import}}
 import algoliasearch.search.SearchParamsObject
 
 def searchRecentlyPublishedBooks(): Future[Unit] = {
   {{> snippets/init}}
 
-  val dateTimestamp = Instant.now.getEpochSecond
+  val dateTimestamp = LocalDateTime.now().minusYears(1).toInstant(ZoneOffset.UTC).getEpochSecond
   val searchParams = SearchParamsObject(
     query = Some("<YOUR_SEARCH_QUERY>"),
     filters = Some(s"date_timestamp > $dateTimestamp")

templates/swift/guides/search/searchFuturePublishedBooks.mustache

@@ -0,0 +1,23 @@
+import Foundation
+#if os(Linux) // For linux interop
+  import FoundationNetworking
+#endif
+
+import Core
+{{> snippets/import}}
+
+func searchFuturePublishedBooks() async throws {
+  do {
+    {{> snippets/init}}
+
+    let dateTimestamp = Int(Date().timeIntervalSince1970)
+    let searchParams = SearchSearchParams.searchSearchParamsObject(
+      SearchSearchParamsObject(query: "<YOUR_SEARCH_QUERY>", filters: "date_timestamp > \(dateTimestamp)")
+    )
+
+    let response: SearchResponse<Hit> = {{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}}
+    print(response)
+  } catch {
+    print(error)
+  }
+}

templates/swift/guides/search/searchRecentlyPublishedBooks.mustache

@@ -10,7 +10,7 @@ func searchRecentlyPublishedBooks() async throws {
   do {
     {{> snippets/init}}
 
-    let dateTimestamp = Int(Date().timeIntervalSince1970)
+    let dateTimestamp = Int(Date().timeIntervalSince1970) - 365 * 24 * 60 * 60
     let searchParams = SearchSearchParams.searchSearchParamsObject(
       SearchSearchParamsObject(query: "<YOUR_SEARCH_QUERY>", filters: "date_timestamp > \(dateTimestamp)")
     )